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H 20074 5 月 Android 开源 手机 平台 问世 以 来 ， 已 经 经 历 了 五 年 的 发 展 。 五 年 间 ， 基 于 
Android 平台 的 智能 手机 迅速 占领 市 场 ， 成 为 当前 最 受 欢迎 的 手机 操作 系统 。 与 之 伴随 的 基 
于 Android 操作 系统 的 应 用 程序 需求 多 元 化 ，Android 开发 技术 成 为 市 场 求职 的 新 宠 。 

为 了 帮助 国内 开发 人 员 快 速 掌握 Android 开发 技术 ， 获 取 更 好 的 就 业 机 会 ， 笔 者 基于 
Google 公司 2011 4E 10 月 发 布 的 Android SDK 4.0 (API Level 14) ， 兼 顾 2012 年 6 月 28 H 
发 布 的 Android SDK 4.1 Jelly Bean (果冻 豆 ) 编写 了 本 书 ， 和 希望 能 够 帮助 广大 读者 在 Android 
开发 的 道路 上 入 门 并 且 获 得 提高 。 

本 书 共 分 为 13 章 ， 由 浅 入 深 地 讲解 了 Android 开发 的 各 个 方面 。 本 书 在 讲解 过 程 中 穿插 
了 大 量 实例 ， 希 望 借 此 能 帮助 读者 更 好 地 理解 Android 开发 的 过 程 。 本 书 的 前 3 章 为 本 书 的 
基础 ， 系 统 地 介绍 了 Android 系统 的 诞生 和 发 展 的 过 程 、Android 的 系统 框架 、Android 开发 
环境 的 搭建 以 及 Android 应 用 程序 的 基本 组 件 ， 并 且 着 重 讲解 了 Android 系统 中 人 机 交互 的 
基本 组 件 Activity 的 基本 知识 。 第 4 章 讲 解 了 Android 开发 过 程 中 界面 开发 的 相关 知识 ， 包 括 
在 用 户 界面 设计 过 程 中 常用 的 布局 和 组 件 ， 以 及 Android 处 理 人 机 交互 事件 的 方法 。 第 5 章 
讲解 了 Intent 的 基本 知识 ， 并 利用 Intent 实现 了 电话 和 短信 应 用 程序 开发 功能 。 第 6 章 主要 
讲解 了 Android 系统 下 的 多 媒体 开发 技术 ， 实 现 了 音频 和 视频 的 播放 。 通 过 Service 和 
BroadcastReceiver 实现 了 后 台 音 频 播放 的 相关 功能 ， 通 过 Android 提供 的 硬件 编程 API 实现 
了 自己 的 录像 和 拍照 应 用 程序 。 第 7 章 讲解 了 Android 系统 提供 的 四 种 数据 存储 方式 ， 分 别 
为 SharedPreferces、 文 件 存储 方式 、 数 据 库 存储 方式 和 ContentProvider。 活 用 这 些 数据 存储 
方式 ， 实 现 数据 持久 化 ， 是 应 用 程序 开发 过 程 中 不 可 回避 的 问题 。 第 8 章 讲解 了 网 络 编程 的 
相关 知识 ， 包 括 HTTP 编程 、Socket 编程 、Bluetooth 编程 和 WIFI 编程 几 方 面 。 第 9 章 解决 
了 利用 Google 提供 的 Google Map API 开发 自己 的 位 置 服务 应 用 的 方法 。 第 10 章 讲解 了 
Android SDK 提供 的 绘图 API， 包 括 2D 绘图 和 3D 绘图 两 个 方面 。 绘 图 技术 是 动画 制作 和 游 
戏 开 发 的 重要 技术 。 第 11 章 讲 解 了 Android 系统 应 用 程序 开发 的 国际 化 和 本 地 化 技术 ， 借 助 
于 该 技术 ， 开 发 人 员 开 发 的 应 用 程序 不 需要 做 任何 的 修改 就 可 以 在 全 球 任 意 地 区 正常 运行 。 
第 12 章 讲解 了 应 用 程序 发 布 的 相关 知识 ， 包 括 应 用 程序 签名 的 策略 、 签 名 文件 的 生成 、 如 何 
对 应 用 程序 签名 以 及 如 何 发 布 到 Google Play Store。 正 确 地 发 布 自 己 开 发 的 应 用 程序 是 利用 
Android 技术 赚 取 第 一 桶 金 的 前 提 条 件 。 第 13 章 讲解 了 Android 4.1 版 本 的 几 个 新 特性 、 安 装 
方法 以 及 Android 4.2 的 新 特性 ， 方 便 感 兴趣 的 读者 尝试 在 Android 4.1 平台 上 学 习 Android F 


本 书 在 编写 时 综合 考虑 了 自学 和 教学 两 方面 因素 。 本 书 不 仅 适合 高 校 教学 ， 学 生 自 学 ， 
同时 也 适合 有 一 定 开发 经 验 的 程序 员 作 为 技术 参考 使 用 。 由 于 本 书 篇 幅 有 限 ， 不 可 能 将 
Android SDK 4.X 开发 的 相关 知识 全 部 进行 讲解 ， 读 者 可 以 参阅 Android SDK 中 所 带 的 文档 
获取 更 多 信息 。 

本 书 第 1 章 和 第 2 章 由 史 江 萍 编写 ， 第 3-13 章 由 李 波 编写 ， 王 祥 凤 对 本 书 的 文字 进行 了 
统 稿 工作 。 感 谢 祝 世 东 、 曾 祥 萍 、 孙 宪 丽 、 杨 弘 平 、 关 颖 、 夏 炎 、 代 钦 、 王 玮 、 王 晓 强 等 在 
本 书 编写 过 程 中 提供 的 帮助 和 支持 。 由 于 笔者 水 平 有 限 ， 编 写 时 间 仓 促 ， 书 中 难免 有 玻 漏 之 
处 ， 恳 请 各 位 读者 、 老 师 批 评 指 正 ， 相 关 指 导 意见 请 发 送 至 introductionandroid(2 gmail.com, 
在 此 笔者 表示 衷心 的 感谢 。 

为 了 方便 读者 学 习 ， 书 中 使 用 的 相关 实例 源 代 码 可 以 从 下 面 网 址 下 载 。 如 果 下 载 有 问 
题 ， 请 联系 邮箱 booksaga@163.com， 邮 件 标题 为 “ 求 Android4X 代 码 ”。 

源 代码 下 载 网 址 : http://download.csdn.net/detail/brucexia/4701948 
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Android 4.X 从 入 门 到 精通 


1.1 智能 手机 


1.1.1 什么 是 智能 手机 


智能 手机 (Smart Phone) ， 是 指 “ 像 个 人 电脑 一 样 具 有 独立 的 操作 系统 ， 可 以 由 用 户 自 
行 安 装 软件 、 游 戏 等 第 三 方 服务 商 提供 的 程序 ， 通 过 此 类 程序 来 不 断 对 手机 的 功能 进行 扩充 
并 可 以 通过 移动 通信 网 络 来 实现 无 线 网 络 接 入 ”的 这 样 一 类 手机 的 总 称 。 

“智能 手机 ”这 个 说 法 主要 是 针对 “功能 手机 (Feature Phone) ”而 言 的 ， 本 身 并 不 意 
味 着 这 个 手机 有 多 “智能 ”; 从 另 一 个 角度 来 讲 ， 所 谓 的 “智能 手机 ”就 是 一 台 可 以 像 电脑 
那样 随意 安装 和 印 载 应 用 软件 的 手机 ， 而 “功能 手机 ” 则 不 能 。Java 的 出 现 使 后 来 的 “功能 
手机 ”具备 了 安装 Java 应 用 程序 的 功能 ， 但 是 Java 应 用 程序 的 操作 友好 性 ， 运 行 效率 及 对 系 
统 资源 的 使 用 情况 都 比 “智能 手机 ” 差 了 很 多 。 

智能 手机 具有 五 大 特点 : 

COD 具备 无 线 接 入 互联 网 的 能 力 ， 即 需要 支持 GSM 网 络 下 的 GPRS 或 者 CDMA 网 络 的 
CDMA 1X 或 3G (wcdma、cdma-evdo、TD-scdma) 网 络 ， 其 至 4G (HSPA+、FDD-LTE、 
TDD-LTE) . 

(2) 具有 PDA 的 功能 ， 包 括 PIM (个 人 信息 管理 ) 、 日 程 记事 、 任 务 安排 、 多 媒体 应 
用 、 浏 览 网 页 。 

(3) 具有 开放 性 的 操作 系统 ， 可 以 安装 更 多 的 应 用 程序 ， 使 智能 手机 的 功能 可 以 得 到 无 
限 扩展 。 

(4) 人 性 化 ， 可 以 根据 个 人 需要 扩展 机 器 功能 。 

(5) 功能 强大 ， 扩 展 性 能 强 ， 第 三 方 软件 支持 多 。 

智能 手机 比 传统 的 手机 具有 更 多 的 综合 性 处 理 能 力 ， 同 传统 手机 外 观 和 操作 方式 类 似 ， 
但 是 传统 手机 使 用 的 是 生产 厂商 自行 开发 的 封闭 式 操作 系统 ， 所 能 实现 的 功能 非常 有 限 ， 不 
具备 智能 手机 的 扩展 性 。 


1.1.2 ”智能 手机 操作 系统 


智能 手机 是 一 种 在 手机 内 安装 了 相应 开放 式 操作 系统 的 手机 ， 随 着 通信 技术 的 发 展 ， 尤 
其 是 第 三 代 移动 通信 技术 (3G) 的 逐步 成 熟 ， 市 场 上 对 功能 更 强 、 扩 展 性 能 更 好 的 智能 手机 
的 需求 量 增长 迅猛 。 具 备 独立 的 操作 系统 是 智能 手机 最 重要 的 特征 。 智 能 手机 操作 系统 是 一 
种 运算 能 力 及 功能 比 传统 功能 手机 系统 更 强 的 手机 系统 。 智 能 手机 操作 系统 领域 也 是 各 手机 
大 厂商 争夺 的 焦点 。 目 前 主流 的 智能 手机 操作 系统 主要 有 Symbian OS, Windows Phone, 
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iOS, Palm OS, BlackBerry OS 和 Android 六 种 。 

各 系统 的 特点 如 下 : 

1. Symbian OS 

塞 班 操作 系统 (Symbian OS) 最 初 是 由 Symbian 公司 (诺基亚 、 索 尼 爱 立信 、 摩 托 罗 
拉 、 西 门 子 等 几 家 大 型 移动 通信 设备 商 共 同 出 资 组 建 的 一 个 合资 公司 ， 专 门 研 发 手机 操作 系 
统 ) 开发 的 ， 其 前 身 是 Psion 公司 推出 的 EPOC (Electronic Piece of Cheese) 操作 系统 ， 是 专 
门 用 于 智能 手机 和 移动 设备 的 32 位 抢占 式 、 多 任务 操作 系统 。 其 内 核 与 GUI (Graphical 
User Interface， 又 称 图 形 用 户 接 口 ) 分开， 功 耗 低 、 占 用 内 存 少 。 

Symbian 操作 系统 在 智能 移动 终端 上 拥有 强大 的 应 用 程序 以 及 通信 能力， 这 都 要 归功 于 
它 有 一 个 非常 健全 的 、 核 心 强大 的 对 象 导向 系统 、 企 业 用 标准 通信 传输 协议 以 及 完美 的 Sun 
Java 语言 。Symbian 认为 无 线 通信 装置 除了 要 提供 声音 沟通 的 功能 外 ， 同 时 也 应 具有 其 他 种 
类 的 沟通 方式 ， 如 触 笔 、 键 盘 等 。 在 硬件 设计 上 ， 它 可 以 提供 许多 不 同 风格 的 外 型 ， 比 如 提 
供 真实 或 虚拟 的 键盘 ， 在 软件 功能 上 可 以 容纳 许多 功能 ， 包 括 和 他 人 分 享 信息 、 浏 览 网 页 、 
发 送 、 接 收 电子 邮件 、 传 真 以 及 个 人 生活 行程 管理 等 。 此 外 ，Symbian 操作 系统 在 扩展 性 方 
面 为 制造 商 预 留 了 多 种 接口 ， 而 且 EPOC 操作 系统 还 可 以 细 分 成 三 种 类 型 :Pearl、Quartz、 
Crystal， 分 别 对 应 普通 手机 、 智 能 手机 和 Hand Held PC 场合 的 应 用 。 

塞 班 操作 系统 为 第 三 方 开发 商 提供 一 个 标准 和 开放 的 平台 环境 。 使 得 第 三 方 应 用 程序 的 
设计 者 能 够 基于 该 平台 开发 自己 的 应 用 软件 。 这 种 方式 带 来 的 不 足 之 处 是 ， 由 于 第 三 方 厂商 
的 用 户 接口 程序 是 不 同 的， 造成 了 软件 不 能 通用 ， 扩 展 性 较 差 。 这 使 得 塞 班 操作 系统 在 办 公 
软件 和 多 媒体 录放 软件 上 没有 开发 出 足够 多 的 软件 供用 户 使 用 。 

多 年 来 Symbian 系统 一 直 占 据 智 能 系统 的 市 场 霸主 地 位 ， 系 统 能 力 和 易 用 性 方面 均 很 出 
色 ， 但 是 在 Android 系统 出 现 后 ，Symbian 系统 的 市 场 占有 率 急剧 下 降 。 

2. Windows Phone 


Windows Phone 最 早 叫 Windows Mobile (简称 WM) 是 微软 针对 移动 设备 而 开发 的 操作 
系统 。 该 操作 系统 的 设计 初衷 是 尽量 接近 于 桌面 版 本 的 Windows， 微 软 按照 电脑 操作 系统 的 
模式 来 设计 WM， 应 用 软件 以 Microsoft Win32 API 为 基础 。2010 年 10 月 Windows Phone 操 作 
系统 正式 发 布 后 ，Windows Mobile 系列 正式 退出 手机 系统 市 场 。 
微软 公司 正式 发 布 了 智能 手机 操作 系统 Windows Phone， 同 时 将 谷歌 的 Android 和 苹果 的 
IOS 列 为 主要 竞争 对 手 。2011 年 2 月 ， 诺 基 亚 与 微软 达成 全 球 战略 同盟 并 深度 合作 共同 研 
发 。2012 年 3 月 21 H, Windows Phone 7.5 登 陆 中国 。6 月 21 日 ， 微 软 正式 发 布 最 新 手机 操 
作 系 统 Windows Phone 8，Windows Phone 8 采用 和 Windows 8 相同 的 内 核 。 

Windows Phone 具有 桌面 定制 、 图 标 拖 搜 、 滑 动 控 制 等 一 系列 前 卫 的 操作 体验 。 其 主屏 
幕 通过 提供 类 似 仪表 盘 的 体验 来 显示 新 的 电子 邮件 、 短 信 、 未 接 来 电 、 上 日 历 约会 等 ， 让 人 们 
对 重要 信息 保持 时 刻 更 新 。 它 还 包括 一 个 增强 的 触摸 屏 界 面 ， 更 方便 手指 操作 ， 以 及 一 个 最 
新 版 本 的 TE Mobile 浏 览 器 ， 该 浏览 器 在 一 项 由 微软 赞助 的 第 三 方 调查 研究 中 ， 和 参与 调研 的 
其 他 手机 浏览 器 相 比 ， 可 以 执行 指定 任务 的 比例 超过 高 达 48%。 很 容易 看 出 微软 在 用 户 操作 
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体验 上 亡 做 出 的 努力 ， 而 史 蒂 夫 - 鲍 尔 默 也 表示 : “全 新 的 Windows 手机 把 网 络 、 个 人 电脑 
和 手机 的 优势 集 于 一 身 ， 让 人 们 可 以 随时 随地 享受 到 想 要 的 体验 。” 


3.i0S 


iOS E 2011 年 6 月 前 叫 iPhone OS， 是 苹果 公司 为 其 移动 设备 开发 的 操作 系统 ， 最 初 是 
设计 给 iPhone 和 iPod touch 使 用 的 。 与 Mac OS X 操作 系统 一 样 ， 它 也 是 以 Darwin 为 基础 
的 。2011 年 6 月 之 后 iOS 的 版 本 为 5 和 6， 通 常 称 为 iDS Fil iOS6。 

苹果 推出 其 第 一 款 智 能 手机 iPhone 后 获得 了 巨大 的 成 功 。iOS 继承 了 Mac OS X 在 个 人 
电脑 上 界面 美观 的 优势 ， 多 点 触摸 技术 的 加 入 为 苹果 iPhone 在 智能 手机 领域 获得 了 可 观 的 市 
场 份额 。iOS 采用 Quartz 图 形 框架 ， 能 够 通过 显卡 硬件 加 速 实现 复杂 的 图 形 显示 。 然 而 iOS 
是 一 个 不 开放 的 平台 ， 用 户 不 能 设计 和 加 载 任何 第 三 方 的 应 用 程序 。 这 使 得 iOS 的 扩展 性 受 
到 很 大 的 限制 。 

4. Palm OS 


Palm OS 是 Palm 公司 开发 的 专用 于 PDA 上 的 一 种 操作 系统 ， 这 是 PDA 上 的 霸主 ， 一 度 
占据 了 90% 的 PDA 市 场 的 份额 。 虽 然 其 并 不 专门 针对 于 手机 设计 ， 但 是 Palm OS 的 优秀 性 
和 对 移动 设备 的 支持 同样 使 其 能 够 成 为 一 个 优秀 的 手机 操作 系统 。 


Palm 操作 系统 是 多 任务 的 ， 但 每 次 只 允许 一 个 应 用 程序 的 打开 ， 多 个 应 用 程序 不 能 同时 


运行 ， 这 使 得 其 运行 速度 很 快 ， 具 有 较 好 的 实用 性 。 但 不 适应 需要 多 应 用 程序 运行 的 场合 。 
5. BlackBerry OS 

BlackBerry OS 是 RIM 47] (Research In Motion) 专用 的 操作 系统 。“ 黑 莓 ” (Black 
berry) 移动 邮件 设备 基于 双向 寻 呼 技术 。 该 设备 与 RIM 公司 的 服务 器 相 结 合 ， 依 赖 于 特定 的 
服务 器 软件 和 终端 ， 兼 容 现 有 的 无 线 数据 链 路 ， 实 现 了 遍及 北美 、 随 时 随地 收发 电子 邮件 的 
梦想 。 这 种 装置 并 不 以 奇妙 的 图 片 和 彩色 屏幕 夺 人 耳目 ， 甚 至 不 带 发 声 器 。 黑 莓 是 目前 在 美 


国 


、 加 拿 大 地 


区 相当 流行 的 无 线 收发 电子 邮件 的 软件 ， 它 将 软件 客户 端 结合 在 移动 电话 、 


PDA 及 其 他 通信 终端 上 ， 用 户 可 以 通过 其 无 线装 置 来 安全 地 访问 电子 邮件 、 企 业 数 据 、Web 
以 及 进行 企业 内 部 的 语音 通话 。 

BlackBerry OS 具有 多 任务 处 理 能 力 ， 并 支持 特定 的 输入 装置 ， 如 滚轮 、 轨 迹 球 、 和 触摸 板 
以 及 触摸 屏 等 。BlackBerry 平台 最 著名 的 莫 过 于 它 处 理 邮 件 的 能 力 。 该 平台 通过 MIDP 1.0 以 
及 MIDP 2.0 的 子 集 ， 在 与 BlackBerry Enterprise Server 连接 时 ， 以 无 线 的 方式 激活 并 与 
Microsoft Exchange, Lotus Domino 或 Novell GroupWise 同步 邮件 、 任 务 、 日 程 、 备 忘 录 和 联 
系 人 。 该 操作 系统 还 支持 WAP 1.2. 

6. Android 

Android 是 一 种 以 Linux 为 基础 的 开放 源码 操作 系统 ， 主 要 应 用 于 便携 设备 。Linux 操作 
系统 的 杠 入 式 版 本 是 为 各 种 资源 受 限 的 嵌入 式 终端 产品 设计 的 。 开 放 的 源码 和 人 免费 供 人 使 用 
的 特点 使 得 Linux 的 应 用 开发 人 员 非 常 丰富 。 而 越 来 越 多 的 智能 手机 开发 商 也 倾向 于 研发 
Linux 智能 手机 以 此 来 降低 手机 成 本 。 相 比 于 其 他 智能 手机 操作 系统 ，Linux 独 有 的 优势 包括 
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以 下 4 个 方面 : 


A) Linux 操作 系统 几乎 能 运行 在 所 有 主流 的 处 理 器 上 ， 如 X86. PowerPC, ARM 等 ; 

(2) Linux 作为 一 个 多 用 户 多 任务 的 操作 系统 ， 符 合 POSIX 便携 式 计算 机 环境 操作 系统 
接口 标准 ; 

(3) Linux 支持 和 鼓励 差异 ， 具 有 良好 的 开放 性 使 得 用 户 可 以 构筑 适合 自己 的 系统 ; 

(4) Linux 是 无 任何 附加 条 件 的 开放 平台 ， 对 硬件 平台 具有 更 好 的 适应 性 ， 可 移植 性 
强 ， 人 允许 定制 用 户 界 面 和 服务 ， 支 持 多 种 格式 的 可 执行 文件 等 。 

Android 操作 系统 最 初 由 Andy Rubin 开 发 ， 最 初 主要 支持 手机 。2005 年 由 Google 收 购 注 
资 ， 并 组 建 开 放手 机 联盟 开发 改良 ， 逐 渐 扩 展 到 平板 电脑 及 其 他 领域 。 它 采用 Linux 2.6.x 版 
本 内 核 ， 采 用 自己 的 GUI 架构 和 应 用 程序 接口 ， 并 采用 Java 语言 来 开发 应 用 程序 。 它 拥有 
Linux 操作 系统 的 开放 性 、 对 硬件 支持 好 等 优点 ， 并 且 界 面 美观 ， 这 使 得 它 受 到 市 场 的 普遍 
欢迎 。Android 的 主要 竞争 对 手 是 苹果 公司 的 iOS 以 及 RIM 的 Blackberry OS. 2011 年 第 一 季 
JE, Android 在 全 球 的 市 场 份额 首次 超过 塞 班 系统 ， 跃 居 全 球 第 一 

Android 的 特点 是 开放 源 代码 ， 它 的 SDK 开放 给 任何 FRM, 所 有 开发 商都 可 以 随意 更 
改 界面 。 


] .2 什么 是 Android 


1.2.1 Android 的 历史 


Android 一 词 最 早出 现 于 法 国 作 家 利 尔 亚当 (Auguste Villiers de l'Isle-Adam) 在 1886 年 
发 表 的 科幻 小 说 《未 来 夏娃 》 (Lieve future) 中 ， 将 外 表 像 人 的 机 器 起 名 为 Android. 

Android 本 意 指 “ 机 器 人 ”， 是 一 个 全 身 绿 色 的 机 器 人 ， 绿 色 也 是 Android 的 标志 。 
Android 最 初 由 现任 Google 工程 副 总 裁 的 安 迪 。 罗 宾 (Andy Rubin) 开发 于 2003 Æ, F 
2005 年 被 Google 收购 。 

Android 是 基于 Linux 内 核 的 软件 平台 和 操作 系统 ， 是 Google 在 2007 年 11 月 5 日 公布 
的 手机 系统 平台 ， 早 期 由 Google 开发 ， 后 由 开放 手机 联盟 (Open Handset Alliance) 开发 。 
它 采用 了 软件 堆 层 CSoftware Stack， 又 名 以 软件 三 层 ) 的 架构 ， 主 要 分 为 三 部 分 。 低 层 以 
Linux 内 核 工作 为 基础 ， 只 提供 基本 功能 ， 其 他 的 应 用 软件 则 由 各 公司 自行 开发 ， 以 Java 作 
为 编写 程序 的 一 部 分 。Android 在 未 公开 之 前 常 被 传闻 为 Google 电话 或 gPhone。 大 多 传闻 认 
为 Google 开发 的 是 自己 的 手机 电话 产品 ， 而 不 是 一 套 软件 平台 。 
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1.2.2 Android 的 发 展 


2003 年 10 月 ，Android 公司 在 加 州 Palo Alto 市 成 立 ， 联 合 创始 人 为 Andy Rubin、Rich 
Miner, Nick Sear 5 Chris White. 

2005 年 8 ], Google 收购 了 成 立 仅 22 个 月 的 高 科技 企业 Android 公司 。 

2007 年 11 H 5H, Google 公司 正式 向 外 界 展示 Android 操作 系统 。Google 与 34 家 手机 
制造 商 、 软 件 开发 商 、 电 信和 运营 商 和 芯片 制造 商 共 同 创建 开放 手持 设备 联盟 。 

2008 年 5 月 28 H, Patrick Brady 于 Google VO 大 会 上 提出 Android HAL 架构 图 ，8 月 18 
日 ，Android 获得 美国 联邦 通信 委员 会 的 批准 。 

Android 软件 一 经 推出 ， 版 本 升级 非常 快 ， 几 乎 每 隔 半年 就 有 一 个 新 的 版 本 发 布 。2008 
年 9 月 发 布 Android 第 一 版 Android 1.1。 后 从 Android 1.5 版 本 开始 ，Android 用 甜点 作为 它们 
系统 版 本 代号 的 命名 方法 。 

2009 4 4 H 30 H, 117; 1.5 版 本 Cupcake (WIERD EREN 

2009 4 9 J] 15 H, Android 1.6 Donut ( 甜 甜 圈 ) 版 本 发 布 。 

2009 年 10 月 26 H, Android 2.0/2.0.1/2.1 Eclair ( 松 饼 ) 版 本 发 布 。 

20104£ 5 J] 20 H, Android 2.2/2.2.1 Froyo CERRI) 软件 发 布 。 

2010 年 12 月 7 日 ，Android 2.3 Gingerbread 〈 姜 饼 ) 版 本 发 布 。 

2011 年 2 月 2 日 ，Android 3.0 Honeycomb (H) 版 本 发 布 。 

2011 年 5 月 11 日 ，Android 3.1 Honeycomb (14) 版 本 发 布 。 

2011 年 7 月 13 H, Android 3.2 Honeycomb (1i) 版 本 发 布 。 

2011 年 10 月 19 日， Android 4.0 Ice Cream Sandwich (冰激凌 三 明治 ) 版 本 在 香港 正式 
发 布 。 

与 比较 通用 的 Android 2.3 相 比 ，Android 4.0 在 系统 上 有 9 大 改进 : 
新 的 UI 界面 更 加 的 人 性 化 。 
新 的 通知 系统 。 
语音 输入 系统 和 面部 识别 功能 。 
新 的 安 卓 浏览 器 。 
大 幅 强 化 了 GMail. 
数据 使 用 管理 功能 。 
拍照 模式 的 强化 。 
新 加 入 的 people 应 用 。 
Android Beam 应 用 。 


2011 12 H 20H, AKR T Android 4.0 操 作 系统 的 最 新 版 本 4.0.3， 称 其 对 Android 
系统 作出 了 多 处 改进 ， 并 修复 了 一 些 缺 陷 。 
2012 Æ 6 H 28 H, Wk 2012 Æ VO 开发 者 大 会 上 发 布 了 Android 4.1 操作 系统 ，Android 
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4.1 Jelly Bean (果冻 豆 ) 是 继 “ 冰 激 凌 三 明治 ”之 后 的 下 一 版 Android 系统 。 

2012 年 10 月 底 ，Google 在 网 上 以 在 线 的 形式 发 布 了 全 新 的 Android 4.2 系统 ， 以 及 新 一 
代 的 Nexus 系列 手机 LG Nexus 4 和 平板 电脑 Nexus 10。Android 4.2 新 系统 界面 改动 不 大 ， 代 
号 还 称 为 Jelly Bean 不 变 ， 新 增 了 系统 全 景 拍照 以 及 无 线 同步 输出 等 实用 的 小 功能 ， 并 在 系 
统 层 面 做 了 更 多 的 优化 。 

Android SDK 4.1 软件 包 已 经 可 以 下 载 ，Android SDK 4.2 过 一 点 时 间 也 可 以 下 载 。 本 书 
在 最 后 一 章 对 这 两 个 版 本 做 了 简单 的 介绍 。 读 者 在 学 习 和 运行 本 书 代码 时 ， 也 可 以 直接 搭建 
和 使 用 这 两 个 开发 环境 。 


1.23 Android 的 优点 

Android 的 优点 主要 包括 以 下 6 项 内 容 : 

1. Android 性 价 比 高 

消费 者 选择 产品 ， 价 格 是 必然 要 考虑 的 一 大 因素 ，iPhone 虽 好 ， 但 是 价格 让 一 般 人 望 而 
却步 。 苹 果 就 像 是 宝马 、 奔 驰 ， 虽 然 大 家 都 认为 它 很 好 ， 但 是 一 般 人 消费 不 起 ， 只 有 看 的 份 
JL. Wi Android 如 同 大 众 ， 满 大 街 跑 的 都 是 ， 甚 至 有 一 些 型 号 是 可 以 与 宝马 、 奔 驰 相 媲 美 
的 。 

虽然 Android 平台 的 手机 廉价 ， 但 是 其 性 能 却 一 点 也 不 低廉 ， 触 摸 效 果 并 不 比 苹果 差 到 
哪里 去 。Android 平台 简单 实用 ， 无 论 是 功能 还 是 外 观 设计 ， 都 可 以 与 苹果 一 决 高 下 。 在 数 
量 众 多 的 Android 手机 中 ， 消 费 者 总 是 会 找到 一 款 满意 的 Android 手机 取代 价格 高 昂 的 


iPhone。 


2. 应 用 程序 发 展 迅速 


智能 手机 玩 的 就 是 个 应 用 ， 虽 然 现 在 Android 的 应 用 还 无 法 与 苹果 相 竞 争 ， 但 是 随 着 
Android 的 推广 与 普及 ， 应 用 程序 的 数量 增长 迅速 ，Android 应 用 在 可 预见 的 未 来 是 有 能 力 与 
苹果 相 竞 争 的 。 而 来 自 Android 应 用 商店 最 大 的 优势 是 ， 不 对 应 用 程序 进行 严格 的 审查 。 在 
这 一 点 上 优 于 苹果 。 


3. 智能 手机 厂家 助力 

现在 ， 世 界 很 多 智能 手机 厂家 几乎 都 加 入 了 Android 阵营 ， 并 推出 了 一 系列 的 Android 
智能 机 。 摩 托 罗 拉 、 三 星 、HTC、LG 等 厂家 都 与 谷歌 建立 了 Android 平台 技术 联盟 。 厂 商 加 
盟 的 越 多 ， 手 机 终端 就 会 越 多 ， 其 市 场 潜力 就 越 大 。 

4. 运营 商 易 力 支持 


在 国内 ， 三 大 运营 商 是 犯 足 了 劲 地 推广 Android 智能 机 。 联 通 的 “0 元 购 机 ”， 电 信 的 
千 元 3G， 移 动 的 索爱 A8i 定制 机 ， 都 显示 了 运营 商 对 Android 智能 机 的 期 望 。 
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在 美国 ，TMobile USA, Sprint, AT&T 和 Verizon 全 部 推出 了 Android 手机 。 此 外 , 日 
本 的 KDDI, NTTDoCoMo, Telecomltalia (意大利 电信 ) . T-Mobile (德国 ) ~ Telefónica 
CHIEF) 等 众多 运营 商都 是 Android 的 支持 者 ， 有 这 么 多 的 运营 商 支 持 Android， 自 然 会 占 
据 巨大 的 市 场 份额 。 


5. 机 型 多 ， 硬 件 配置 优 


自从 Google 推出 Android 系统 以 来 ， 各 大 厂家 纷纷 推出 自己 的 Android 平台 手机 ， 
HTC、 索 尼 爱 立信 、 峰 族 、 摩 托 罗拉 、 夏 普 、LG、 三 星 、 联 想 等 都 推出 了 各 自 的 Android F 
机 ， 机 型 多 样 ， 数 不 胜 数 。 


6. 系统 开源 利于 创新 


Android 是 开源 的 ， 允 许 第 三 方 修改 ， 这 在 很 大 程度 上 容许 厂家 根据 自己 的 硬件 更 改版 
本 ， 从 而 能 够 更 好 地 适应 硬件 ， 与 之 形成 良好 的 结合 。 开 源 能 够 提供 更 好 的 安全 性 能 ， 也 给 
开发 人 员 提供 了 一 个 更 大 的 创新 空间 ， 从 而 使 Android 版 本 升级 更 快 。 


] .3 Android 系统 架构 


1.1 是 Android 操作 系统 的 架构 ， 架 构 包 括 4 层 ， 由 上 到 下 依次 是 应 用 程序 层 、 应 用 程 
序 框架 层 、 核 心 类 库 和 Linux 内 核 。 其 中 核心 类 库 中 包含 了 系统 库 及 Android 运行 环境 。 


APPLICATIONS 


Linux KERNEL 


Flash Memory 
‘Camera Driver D 


Audio 
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1.3.1 ”应 用 程序 层 (Applications ) 


Android 装配 一 个 核心 应 用 程序 集合 ， 包 括 E-mail 客户 端 、SMS 短 消息 程序 、 日 历 、 地 
图 、 浏 览 器 、 联 系 人 管理 程序 和 其 他 设置 ， 所 有 应 用 程序 都 是 用 Java 编程 语言 编写 的 。 用 户 
开发 的 Android 应 用 程序 和 Android 的 核心 应 用 程序 是 同一 层次 的 ， 它 们 都 是 基于 Android 的 
系统 API 构建 的 。 


1.3.2 ”应 用 程序 框架 层 CApplication Framework) 


应 用 程序 的 体系 结构 旨 在 简化 组 件 的 重用 ， 任 何 应 用 程序 都 能 发 布 它 的 功能 且 任何 其 他 
应 用 程序 都 可 以 使 用 这 些 功 能 〈 需 要 服从 框架 执行 的 安全 限制 ) ， 这 一 机 制 允 许 用 户 蔡 换 组 
件 。 开 发 者 完全 可 以 访问 核心 应 用 程序 所 使 用 的 API 框架 。 通 过 提供 开放 的 开发 平台 ， 
Android 使 开发 者 能 够 编制 极其 丰富 和 新 颖 的 应 用 程序 。 开 发 者 可 以 自由 地 利用 设备 硬件 优 
势 访问 位 置信 息 ， 运 行 后 台 服务 ， 设 置 闹钟 ， 向 状态 栏 添加 通知 等 。 

所 有 的 应 用 程序 都 是 由 一 系列 的 服务 和 系统 组 成 的 ， 主 要 包括 以 下 几 种 : 


e 视图 (Views) 。 这 里 的 视图 指 的 是 丰富 的 、 可 扩展 的 视图 集合 ， 可 用 于 构建 一 个 应 
用 程序 ， 包 括 列 表 (Lists) 、 网 格 (Grids) 、 文 本 框 (TextBoxes ) . #40 
(Buttons) , 3 £X 9a Web 浏览 器 。 

© 内 容 管 理 器 (Content Providers) 。 内 容 管理 器 使 得 应 用 程序 可 以 访问 另 一 个 应 用 程 
序 的 数据 ( 如 联系 人 数据 库 ) 或 者 共享 自己 的 数据 。 

e 资源 管理 器 (Resource Manager) 。 资 源 管理 器 提供 访问 非 代 码 资 源 ， 如 本 地 字符 
串 、 图 形 和 分 层 文件 (layout files) 。 

e 通知 管理 器 (Notification Manager) 。 通 知 管理 器 使 得 所 有 的 应 用 程序 都 能 够 在 状态 
栏 显示 通知 信息 。 

e 活动 管理 器 (Actüviy Manager) 。 在 大 多 数 情况 下 ， 每 个 Android 应 用 程序 都 运行 在 
自己 的 Linux 进程 中 。 当 应 用 程序 的 某 些 代码 需要 运行 时 ， 这 个 进程 就 被 创建 并 一 直 
pilin 直到 系统 认为 该 进程 不 再 有 用 为 止 ， 然 后 系统 将 回收 该 进程 占用 的 内 存 以 

便 分 配给 其 他 的 应 用 程序 。 活 动 管理 器 管理 应 用 程序 生命 周期 ， 并 且 提 供 通用 的 导航 
we 


1.3.3 RAAE (Libraries) 


Android 本 地 框架 是 由 C/C++ 实现 的 ， 包 含 了 C/C++ 库 ， 以 供 Android 系统 的 各 个 组 件 使 
用 。 这 些 功 能 通过 Android 的 应 用 程序 框架 为 开发 者 提供 服务 。 
里 只 介绍 C/C++ 库 中 的 一 些 核心 库 : 


e 系统 C 库 。 标 准 C 系 统 库 (libc) 4 BSD 衍生 ， 调 整 为 基于 嵌入 式 Linux HA. 
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e 媒体 库 。 基 于 PacketVideo 的 OpenCORE， 这 些 库 支持 播放 和 录制 许多 流行 的 音频 和 
视频 格式 ， 以 及 静态 图 像 文 件 ， 包 括 MPEG4、H264、MP3、AAC、AMR、JPG、 
PNG. 

e@ 界面 管理 。 管 理 访问 显示 子 系统 ， 并 且 为 多 个 应 用 程序 提供 2D 和 3D 图 层 的 无 终 融 


合 。 


* LibWebCore。 新 式 的 Web 浏览 器 引擎 ， 支 持 Android 浏览 器 和 内 谈 的 web 视图 。 

e SGL。 一 个 内 置 的 2D 图 形 引 擎 。 

© 3D È. 基于 OpenGL ES 1.0 APIs 的 实现 ， 该 库 可 以 使 用 硬件 3D 加 速 或 包含 高 度 优 
化 的 3D 软件 光栅 。 

* FreeType。 位 图 和 矢量 字体 显示 泻 染 。 

* SQLite, SQLite 是 一 个 所 有 应 用 程序 都 可 以 使 用 的 强大 而 轻 量 级 的 轻型 关系 数据 库 引 
学。 


1.3.4 Android 运行 环境 (Android Runtime) 


Android 包含 一 个 核心 库 的 集合 ， 该 核心 库 提供 了 Java 编程 语言 核心 库 的 大 多 数 功 能 。 
几乎 每 一 个 Android 应 用 程序 都 在 自己 的 进程 中 运行 ， 都 拥有 一 个 独立 的 Dalvik 虚拟 机 实 
例 。 

Dalvik 是 Google 公司 自己 设计 用 于 Android 平台 的 Java 虚拟 机 。Dalvik 虚拟 机 是 Google 
等 厂商 合作 开发 的 Android 移动 设备 平台 的 核心 组 成 部 分 之 一 。 它 可 以 支持 已 转换 为 dex 
(El Dalvik Executable) 格式 的 Java 应 用 程序 的 运行 ，.dex 格式 是 专 为 Dalvik 设计 的 一 种 压缩 
格式 ， 适 合 内 存 和 处 理 器 速度 有 限 的 系统 。Dalvik 经 过 优化 ， 允 许 在 有 限 的 内 存 中 同时 运行 
多 个 虚拟 机 的 实例 ， 并 且 每 一 个 Dalvik 应 用 作为 一 个 独立 的 Linux 进程 执行 。Dalvik 虚拟 机 
依赖 于 Linux 内 核 提 供 基 本 功能 ， 如 线程 和 底层 内 存 管理 。 


1.3.5 Linux 内 核 (Linux Kernel) 


Android 基于 Linux 提供 核心 系统 服务 ， 例 如 : 安全 、 内 存 管理 、 进 程 管理 、 网 络 堆栈 、 
驱动 模型 。 除 了 标准 的 Linux 内 核 外 ，Android 还 增加 了 内 核 的 驱动 程序 : Binder (IPC) 3K 
动 、 显 示 驱 动 、 输 入 设备 驱动 、 音 频 系统 驱动 、 摄 像 头 驱动 、WiFi 驱动 、 蓝 牙 驱 动 、 电 源 管 
理 。 


Linux 内 核 也 作为 硬件 和 软件 之 间 的 抽象 层 ， 它 隐藏 具体 硬件 细节 而 为 上 层 提供 统一 的 
服务 。 分 层 的 好 处 就 是 使 用 下 层 提供 的 服务 而 为 上 层 提 供 统一 的 服务 ， 屏 蔽 本 层 及 以 下 层 的 
差异 ， 当 本 层 及 以 下 层 发 生 了 变化 而 不 会 影响 到 上 层 ， 可 以 说 是 高 内 聚 、 低 耦合 。 
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1.4 avs 


本 章 介绍 了 智能 手机 的 概念 及 其 流行 的 操作 系统 ， 并 对 当前 最 流行 的 Android 操作 系统 
进行 了 详细 介绍 ， 从 其 产生 、 发 展 过 程 中 得 出 其 优势 所 在 。 

本 章 重点 介绍 了 Android 操作 系统 的 系统 构架 ， 并 从 应 用 程序 层 、 应 用 程序 框架 层 、 核 
心 类 库 和 Linux 内 核 五 个 部 分 进行 了 详细 的 介绍 。 


] .与 ”思考 题 


1. 了解 Android 系统 的 发 展 过 程 。 
2. Android 系统 架构 分 为 哪 几 层 ? 
3. 系统 库 中 的 核心 库 有 哪些 ? 它们 的 作用 分 别 是 什么 ? 


搭建 Android 开发 环境 


从 本 章节 可 以 学 习 到 : 

> 系统 需求 

^ 软件 安装 

* Android SDK 介绍 

* 创建 第 一 个 Android 应 用 程序 
^ 调试 程序 
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2 .| BE 


支持 Android 开发 的 系统 如 下 ， 读 者 可 以 选择 自己 喜欢 的 系统 平台 。 


€ Windows XP (32 位 ) 、Vista (32 位 或 64 位) . Win7 (32 位 或 64 位) 。 
© Mac OS 义 10.5.8 或 以 后 版 本 (x86) 。 
€ Linux Ubuntu. 


2.2 软件 安装 


2.2.1 JDK 的 安装 
JDK 的 安装 步骤 说 明 如 下 : 


人 ET) 下 载 JDK。 通 过 Android 系统 架构 可 以 知道 ， 要 进行 开发 需要 下 载 安装 Java 的 开发 
环境 。 首 先 需要 下 载 免费 IDK 软件 包 。Android SDK 需要 JDKS 以 上 版 本 ，JDK 包 
含 了 一 整套 开发 工具 。 由 于 Sun 公司 已 经 被 Oracle 公司 收购 ， 因 此 需要 到 Oracle 
公司 的 网 站 下 载 ， 下 载 地 址 是 : http://www.oracle.com/technetwork/java/javase/ 
downloads/index.html， 值 得 注意 的 是 ， 必 须 下 载 完整 的 IDK 开发 包 ， 不 可 以 只 
装 JRE 运行 版 本 (下载 界面 如 图 2.1 所 示 ) 。 目 前 最 新 版 本 是 JDK7， 但 是 为 了 更 
好 的 稳定 性 ， 建 议 使 用 JDK6。 

C€XX02 安装 JDK。 双 击 下 载 的 可 执行 文件 ， 接 受 许可 后 就 可 以 安装 了 。 安 装 过 程 比较 简 
单 ， 就 不 再 展开 描述 了 。 

G23 配置 Java 环境 变量 。 为 了 使 用 Java 工具 进行 编译 、 运 行 ， 需要 配置 Java 环境 变 
E, 采用 相对 路 径 的 方法 ， 需 要 设置 的 三 个 环境 变量 : JAVA HOME, 
CLASSPATH 和 PATH. 假设 将 IDK 安装 到 了 C:\JAVA\IJDK6\ 路 径 下 ， 则 右 击 “我 
的 电脑 ”| “属性 ”| “高 级 ”| “环境 变量 ”: 


* 配置 JAVA HOME: JAVA HOME- “C:\JAVA\IDK6\” . 
* B. X CLASSPATH: CLASSPATH= “.; %JAVA_HOME%)\jre\lib\rt jar;” . 
* 配置 PATH: PATH= “%JAVA_HOME%\bin:” . 
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PT 


T 


C O www.oracle.com/technetw amiosd: 


Marr. pua [S conne- n om Ozwzxmes: Qzem mcn 


ORACLE (aminman) Untes Sats = Commune Iama meto. Riesen ies 
Products an Sormees Shitons Downloads Sime api Tram, ates beat 


| Soja. || SII | Ljavate 
I eee 


Java Panom ond Java 202 


Here are the Java SE downloads in detat 
Java Platform, Standard Edition. 

Java SE Tus JOK JRE 

Tra wesse nvon eo tues umam OE CID 


Wast Java Do NeedT You must hare a copy othe 
JRE Uma Runtme Emonmeng on your sem in OKT Ons JRE 7 Docs 
“Java aggiorna and apples To develop Joc 


图 2.1 JavaJDK 下 载 界面 


2.2.2 Android SDK 


开发 Android 应 用 程序 需要 下 载 相关 的 Android SDK。 到 http://developer.Android.com/ 


sdk/index.html Android 开发 网 页 ， 根 据 自己 的 操作 系统 下 载 Android SDK 软件 开发 包 。 
Android SDK 更 新 很 快 ， 本 页 面 提供 的 是 4.0 版 本 的 Android SDK 的 下 载 。 即 使 在 本 书 的 书 
写 过 程 中 ，SDK 的 版 本 也 更 新 了 几 次 。 因 为 Android SDK 向 下 兼容 ， 建 议 读者 下 载 最 新 版 


本 。 
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为 了 方便 起 见 ， 本 书 使 用 的 是 Android SDK r14 版 本 ， 下 载 页 面 如 图 2.2 所 示 。 


LEES 


e © © developer android com/scte/ingex nim 
mF ewan Goon su Qemmomca © a Oowarsven 

o Go E 
developers 


rm LJ 


Download the Android SDK 


Welcome Developers! you ar ew tothe Androc SOK, please read the steps below, for an coin of how to set vp the SOK 
‘Aes SEK. you should vite to pe teat toats oe tem using te Arr SOK sec AYO Manager eter —Ó new SOR sare package 


Mac OS X (et) wr 2d ts- macean ze RAT bytes AADA endse cni QeetetesTom 
IMMMA bytes Mots dS ADITA CIMA 


22 Android SDK 软件 开发 包 下 载 界 面 
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下 载 完成 后 ， 打 开 目 录 找 到 SDK Setup.exe 可 执行 文件 ， 双 击 执行 该 文件 即 可 安装 。 
Android SDK 包含 了 开发 Android 应 用 所 依赖 的 jar 文件 、 运 行 环境 及 相关 工具 。 


2.2.3 Eclipse 和 ADT 


1. 安装 Eclipse 集成 开发 环境 


目前 Eclipse 3.4 或 3.5 版 本 都 可 以 支持 Android 应 用 程序 开发 ， 可 以 到 Eclipse 官方 网 站 
下 载 Eclipse 3.5 开发 包 ， DENS /www.eclipse.org/downloads/, E] 2.3 所 示 。 


SESS Downloads 


Packages Developer Builds Projects 


Eclipse IDE for Java EE Developers 21200 


0 Tes 
qp Eclipse Classic 3.7.2 «un 
(cji Eclipse IDE for Java Developers 12s ua 
Tool Suite. 

a ok 
(Q. Eclipse IDE for C/C++ Developers (includes incubating componente) 

Downloaded 48.377 Tes — Duas 
A Eclipse IDE for Java and Report Developers. 243 we 
Wt Dewnessed 16,782 Tes ^ Detur 
GD Eee OE tor Javascript Web Developers. vois 


qp Eclipse Modeling Tools 272 us 


Tans Times 


图 2.3 Eclipse 下 载 界面 


选择 “Eclipse IDE Java Developers ”就 会 链接 到 下 载 界面 。 解 开 下 载 的 压缩 包 ， 放 到 
Windows 目录 下 即 可 。 


2. 安装 Android 开发 工具 ADT 


ADT 即 Android Development ToolKit。 在 安装 Android 开发 工具 ADT 之 前 ， 应 该 先 安装 
Eclipse 集成 开发 环境 。 然 后 启动 Eclipse， 选 择 Help->Install New Software， 在 出 现 的 对 话 框 
里 ， 单 击 Add 按钮 ， 在 对 话 框 的 Name 一 栏 输入 ADT, Location 一 栏 填 入 https:/dl- 
sslL.Google.com/Android/eclipse/， 然 后 可 以 在 线 下 载 ， 或 者 单 击 Archive 按钮 ， 浏 览 和 选择 已 
经 下 载 的 ADT 插件 压缩 文件 。ADT 的 安装 文件 可 以 到 http://developer.Android.com/sdk/ 
eclipse-adt.html#installing 下 载 ， 如 图 2.4, 2.5 所 示 。 单 击 Next 按钮 ， 弹 出 对 话 框 重启 Eclipse 
即 可 。 
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Stoked 
D 
mc 
E 


FA 2.5 Android 开发 工具 ADT 安装 


3. 设置 ADT 
假设 Android SDK 安装 在 E:\Android 下 ， 则 把 Android SDK 文件 夹 下 的 如 下 目录 添加 到 
环境 变量 : E:\Android\ Android-sdk\platform-tools;E:\Android\ Android-sdk\platform-tools\tools; 
之 后 执行 “开始 菜单 ”|“ 运 行 ”| cmd， 输 入 adb 命令 ， 若 出 现 如 图 2.6 所 示 的 内 容 则 表示 环 
境 变 量 设置 成 功 。 


to the only con 


r if more than one 


command to the 


the given serial number. 


-p «product name or path? 


out directory like 'out/tarq 


If s not specified, the ANDROID_PRODUCT_OUT 


environment variable sed, which must 


图 2.6 环境 变量 配置 成 功 图 
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ADT 安装 完成 后 ， 在 Eclipse 中 单 击 Window | Android SDK Manager 命令 ， 启 动 Android 
SDK Manager， 在 线 下 载 相关 开发 工具 、 文 档 、 示 例 代码 ， 如 图 2.7 所 示 。Android SDK 
Manager 会 显示 所 有 版 本 的 SDK， 本 书 下 载 的 是 Android4.0 (API14) 版 本 。 


SDK Path: C:\Program Files (86) Android android-sdk 
Packages 
@ Name 
^ EE Took] 
i| X Android SOK Tools diy Installed 
[Vi sip Android SDK Platform-toois. # Not installed 
4 DS Android 4.03 (APT15) 
| Documentation for Android SOK 15 Not installed 
[ SDK Platform. # Not instatied 
I| Q Somples for SOK A Not instalied 
[Vi ARM EAB! v7a System image # Not installed 
I] % Google APIs by Google Inc. $ Not installed 
iB) Sources for Android SOK 15 AM Not instatied 
77] (ài Android 4.0 (APL14) 
E) i Android 32 (A113) 


FE) G} Android 311 (APT 12) 
1/25 Andenid IA (ADEM 


Show: |VUpdates/New |VInstalled [| Obsolete Select New or Updates 
Sort by: @ API level © Repository Deselect All 


Done loading packages. 


图 2.7 Android 开发 环境 配置 


在 Eclipse 中 单 击 window | preference 命令 ， 显 示 相关 配置 选项 。 在 左 侧 选择 Android 选 
项 ， 在 右 侧 的 SDK Location 中 选择 SDK 安装 目录 ， 然 后 单 击 OK 按钮 ， 如 图 2.8 所 示 。 
(8) Preferences "A 4 mmm) 
type filter text Android Pe 


Android Preferences 
‘Ant SDK Location: Q:\android\android-sdk 


Data Management Note: The list of SDK Targets below is only reloaded once you hit ‘Apply’ or ‘OK’. 
> lod Target Name Vendor Platform API „u 
> java Android 4.0 Android Open Source Projet — 40 14 
Java EE Google APIs Google Inc. 40 14 
Java Persistence 
JavaScript 
Mylyn 
Plug-in Development. 
Remote Systems 
Run/Debug 
> Server 


> Team 
Terminal 

» Usage Data Collector 
Validation 
Web 

» Web Services 


ian 
@ Co Jo em] 


IS = d 


2.8 ”相关 配置 选项 
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2.2.4 创建 AVD 


在 Eclipse 中 单 击 Window | AVD Manager 命令 ， 启 动 Android 虚拟 设备 管理 器 。 单 击 
New 按 钮 ， 新 建 一 个 虚拟 设备 ， 如 图 2.9 所 示 。 


create new Android Virtual Device (AVD) [x) 


i [Android 4.0 ~ API Level 14 


nem ( 


size: [205 lIms v] 
Ofile: ] [Browse 


Enabled. 


(Built-in: [Default (¥VGABOO) x] 


OResolution: [ x zs] 


Property Value [ie] 
Abstracted LCD density 240 
lax VM application h... 24 Delete 
Device ram size 512 


e existing AVD with the sane mane 


Cancel 


图 2.9 创建 AVD 


2.2.5 AVD 与 真 机 的 区 别 


AVD 提供 了 近乎 真实 手机 的 虚拟 环境 ， 以 便于 程序 员 进 行 调试 。 但 是 AVD 毕竟 不 是 真 
机 ， 有 些 功 能 目前 AVD 尚 不 能 模拟 。 比 如 : 


AVD 不 支持 真实 的 电话 接听 和 呼叫 ， 但 是 可 以 通过 控制 台 模 拟 电话 呼叫 。 
AVD 不 支持 USB 连接 。 

AVD 不 支持 相机 /视频 捕捉 (输入) 。 

AVD 不 支持 耳机 。 

AVD 不 支持 蓝牙 。 

AVD 不 能 在 运行 时 确认 SD 卡 的 插入 和 弹出 状态 。 

AVD 不 能 确定 电池 的 电量 多 少 和 充电 状态 。 

AVD 不 能 确定 连接 状态 。 
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2 " 3 Android SDK 介绍 


SDK (software development kit) 软件 开发 工具 包 ， 是 软件 开发 工程 师 用 于 为 特定 的 软件 
包 、 软 件 框架 、 硬 件 平 台 、 操 作 系统 等 建立 应 用 软件 的 开发 工具 的 集合 。Android SDK 就 是 
Android 专 属 的 软件 开发 工具 包 。 
2.3.1 Android SDK 目录 结构 


Android SDK 解压 即 可 完成 安装 ， 其 中 包含 的 文件 、 文 件 夹 如 图 2.10 所 示 。 


J add-ons 

J docs 

P] extras 

J platforms 

J platform-tools 
J samples 


点 system-images 
I temp 

J tools 

'* AVD Manager.exe 
$ SDK Manager.exe 
L] SDK Readme.txt 
@ uninstall.exe 


图 2.10 Android SDK 目录 结构 图 


(1) add-ons 

该 目录 中 存放 Android 的 扩展 库 ， 比 如 Google Maps， 但 是 如 果 未 选择 安装 Google API, 
则 该 目录 为 空 。 

(2) docs 

该 目录 是 developer.Android.com 的 开发 文档 ， 包 含 SDK FA. LH. ADT 等 的 介绍 ， 
开发 指南 ，API 文档 ， 相 关 资 源 等 。 

(3) extras 

该 目录 用 于 存放 Android 附加 支持 文件 ， 主 要 包含 Android 的 support LF, Google 的 
几 个 工具 和 驱动 、Intel 的 IntelHaxm。 

(4) platforms 

该 目录 用 于 存放 Android SDK Platforms 平台 相关 文件 ， 包 括 字 体 、res 资源 、 模 板 等 。 

(5) platform-tools 

该 目录 包含 各 个 平台 工具 ， 其 中 主要 包含 以 下 几 部 分 。 
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* api 目录 。api-versions.xml 文 件 ， 用 于 指明 所 需 类 的 属性 、 方 法 、 接 口 等 。 

* lib 目录。 lib 目录 中 只 有 dx.jar 文 件 ， 为 平台 工具 启动 dx.bat 时 加 载 并 使 用 jar 包 里 的 
类 。 

e aapt.exe。 主 要 作用 是 把 开发 的 应 用 打包 成 apk 安装 文件 ， 如 果 用 eclipse FA, WA 
用 通过 命令 窗口 输入 命令 + 参数 实现 打包 。 

* adb.exe. Adb FP Android Debug Bridge 调试 桥 ， 可 以 通过 它 连接 Android 手机 (或 模 
拟 器 ) 和 与 PC 端 ， 可 以 在 PC 端 上 控制 手机 的 操作 。 如 果 用 Eclipse 开发 ， 一 般 情况 
T adb 会 自动 启动 ， 之 后 我 们 可 以 通过 DDMS 来 调试 Android 程序 。 

* aidlexe。AIDL 全 称 Android Interface Definition Language, 7 Android 内 部 进程 通信 
接口 的 描述 语言 ， 用 于 生成 可 以 在 Android 设备 进行 进程 间 通 信 (IPC) 的 代码 。 

* dexdump.exe。 使 用 dexdump 可 以 反 编译 .dex 文件 ， 例 如 dex 文件 里 包含 3 个 类 ， 反 
编译 后 也 会 出 现 3 个 .class 文 件 ， 通 过 对 这 些 文 件 可 以 大 概 了 解 原 始 的 java 代码 。 

* dx.bat。 其 功能 是 将 .class 字 节 码 文 件 转 成 Android 字 节 码 .dex 文件 。 

* fastboot.exe。 通 过 fastboot 可 以 重启 系统 、 重 写 内 核 、 查 看 连接 设备 、 写 分 区 、 清 空 
分 区 等 操作 。 

* Android llvm-rs-cc.exe, Renderscript 采用 LLVM 低 阶 虚拟 机 .llvm-rs-cc.exe 主要 作用 是 
对 Renderscript 的 处 理 。 

e NOTICE.xt 和 source.properties, NOTICE.txt 只 是 给 出 一 些 提示 的 信息 ; 
source.properties 是 资源 属性 信息 文件 ， 主 要 是 该 资源 生成 时 间 、 系 统 类 型 、 资 源 
URL 地 址 等 等 。 


(6) samples 

samples 是 Android SDK 自 带 的 默认 示例 工程 ， 里 面 的 apidemos 强烈 推荐 初学 者 进行 学 
习 ， 对 于 SQLite 数据 库 操作 可 以 查看 NotePad 例子 ， 对 于 游戏 开发 可 以 参考 Snake 和 
LunarLander， 对 于 Android 主题 开发 Home 则 是 Android m5 时 代 的 主题 设计 原理 。 

(7) system-images 

该 目录 存放 系统 用 到 的 所 有 图 片 。 

(8) temp 

该 目录 存放 系统 中 的 临时 文件 。 

(9) tools 

作为 SDK 根 目录 下 的 tools 文件 来， 这 里 包含 了 重要 的 工具 ， 比 如 dims 用 于 启动 
Android 调试 工具 ，logcat、 屏 幕 截 图 和 文件 管理 器 ， 而 draw9patch 则 是 绘制 Android 平台 的 
可 缩放 png 图 片 的 工具 ，sqlite3 可 以 在 PC 上 操作 SQLite 数据 库 ， 而 monkeyrunner 则 是 一 个 
不 错 的 压力 测试 应 用 ， 模 拟 用 户 随机 按钮 ，mksdcard 则 是 模拟 器 SD 映像 的 创建 工具 ， 
emulator 是 Android 模拟 器 主 程序 ， 不 过 从 Android 1.5 开始 ， 需 要 输入 合适 的 参数 才能 启动 
模拟 器 ，traceview 作为 Android 平 台 上 重要 的 调试 工具 。 
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2.3.2 Android.jar 

作为 一 个 Java 项 目 ， 通 常情 况 下 都 会 引入 要 用 到 的 工具 类 ， 也 就 是 Jar 包 ， 在 Android 
开发 中 ， 绝 大 部 分 开发 用 的 工具 包 都 被 封装 到 一 个 名 叫 Android jar 的 文件 里 了 。 在 Eclipse 中 
展开 来 看 ， 可 以 看 到 j2se 中 的 包 ，apache 项 目 中 的 包 ， 还 有 Android 自身 的 包 文件 。Android 
的 包 文件 主要 包括 以 下 内 容 : 


Android.app: 提供 高 层 的 程序 模型 和 基本 的 运行 环境 。 
Android.content: 包含 各 种 对 设备 上 的 数据 进行 访问 和 发 布 的 类 。 
Android.database: 通过 内 容 提供 者 浏览 和 操作 数据 库 。 
Android.graphics: 底层 的 图 形 库 。 

Android.location: 定位 和 相关 服务 的 类 。 

Android.media: 提供 一 些 类 管理 多 种 音频 、 视 频 的 媒体 接口 。 
Android.net: 提供 帮助 网 络 访问 的 类 ， 超 过 通常 的 java.net.* 接 口 。 
Android.os: 提供 了 系统 服务 、 消 息 传输 、IPC 机 制 。 
Android.openg : 提供 OpenGL 的 工具 。 

Android.provider: 提供 类 ， 访 问 Android 的 内 容 提供 者 。 
Android.telephony: 提供 与 拨打 电话 相关 的 API 交互 。 
Android.view: 提供 基础 的 用 户 界面 接口 框架 。 

Android.util: 涉及 工具 性 的 方法 ， 例 如 时 间 日 期 的 操作 。 
Android.webkit: 默认 浏览 器 操作 接口 。 

Android.widget: 包含 各 种 UI 元 素 ( 大 部 分 是 可 见 的 ) 在 应 用 程序 的 屏幕 中 使 用 .。 


2.8.8 Android API 核心 包 


SDK 中 集成 了 很 多 开发 应 用 的 API， 它 们 是 通过 Android SDK 来 编写 应 用 程序 的 基础 ， 
这 里 我 们 从 最 底层 到 最 高 层 列 出 核心 包 并 加 以 说 明 。 


Android.util: 包含 一 些 底层 辅助 类 ， 例 如 : 特定 的 容器 类 ，XML 辅助 工具 类 等 。 

Android.os: 提供 基本 的 操作 服务 ， 消 息 传递 和 进程 间 通 信 IPC。 

Android.graphics: ABW, REA ERD fie. 

Android.text Android.text method Android.text.style Android.text.util: 提供 一 套 丰 富 的 文 

本 处 理工 具 ， 支 持 富 文本 ， 输 入 模式 等 。 

Android.database: 包含 底层 API 处 理 数据 库 ， 方 便 操作 数据 库 表 和 数据 。 

© Android.content: 提供 各 种 服务 访问 数据 在 手机 设备 上 ， 程 序 安 装 到 手机 设备 和 其 他 
相关 资料 。 

* Android.view: 核心 用 户 界面 框架 。 

* Android.widget: 提供 标准 用 户 界 面 元 素 ，List (列表 ) ，Buttons (#42) , Layout 
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manager ( 布局 管理 器 ) 等 ， 是 组 成 我 们 界面 的 基本 元 素 。 
Android.app: 提供 高 层 应 用 程序 模型 ， 实 现 使 用 Activity. 
Android.provider: 提供 方便 调用 系统 提供 的 content providers 的 接口 。 
Android.telephony: 提供 API 和 手机 设备 的 通话 接口 。 
Android.webikit: 包含 一 系列 工作 在 基于 Web 内 容 的 API 


2.84 Android API 扩展 包 


核心 的 Android API 在 每 部 手机 上 都 可 使 用 ， 但 仍然 有 一 些 API 接口 有 各 自 特别 的 适用 
范围 这 就 是 所 谓 的 “可 选 API”。 这 些 API 之 所 以 是 “可 选 的 ”， 主 要 是 因为 一 个 手持 设 
备 并 不 一 定 要 完全 支持 这 类 API， 甚 至 于 完全 不 支持 。 


Location-Based Services 定位 服务 。Android 操作 系统 支持 GPS API-LBS， 可 以 通过 集 
成 GPS 芯片 来 接收 卫星 信号 通过 GPS 全 球 定位 系统 中 至 少 3 颗 卫 星 和 原子 钟 来 获取 
当前 手机 的 坐标 数据 ， 通 过 转换 就 可 以 成 为 地 图 上 的 具体 位 置 了 ， 这 一 误差 在 手机 上 
可 以 缩小 到 10 米 。 在 谷歌 开发 手机 联盟 中 可 以 看 到 著名 的 SiRF star。 所 以 未 来 
gPhone 手机 上 市 时 集成 GPS 后 的 价格 不 会 很 贵 。 同 时 谷歌 正在 研制 基于 基站 式 的 定 
位 技术 -MyLocation 可 以 更 快速 地 定位 与 前 者 GPS 定位 需要 花费 大 约 1 分 钟 相 比 基 站 
定位 更 快 。 

Media APIs 多 媒体 接口 。Android 平台 上 集成 了 很 多 影音 解码 器 以 及 相关 的 多 媒体 
API， 通 过 这 些 可 选 API， 厂 商 可 以 让 手机 支持 MP3、MP4、 高 清晰 视频 播放 处 理 等 。 
3D Graphics with OpenGL 3D 图 形 处 理 OpenGL 可 选 API. Android 平台 上 的 游戏 娱乐 
功能 如 支持 3D 游戏 、 或 应 用 场景 就 需要 用 到 3D 技术 ， 手 机 生产 厂商 根据 手机 的 屏 
幕 以 及 定位 集成 不 同等 级 的 3D 加 速 图 形 芯片 来 加 强 gPhone 手机 的 娱乐 性 ， 有 来 自 高 
通 的 消息 称 最 新 的 显示 芯片 在 gPhone 上 将 会 轻松 超过 索尼 PS3。 

Low-Level Hardware Access 低级 硬件 访问 。 这 个 功能 主要 用 于 控制 手机 的 底层 方面 操 
作 ， 由 于 设计 底层 硬件 操作 ， 将 主要 由 各 个 手机 硬件 生产 厂商 来 定制 ， 支 持 不 同 设备 
的 操作 管理 等 ， 如 蓝牙 Bluetooth 以 及 WIFI 无 线 网 络 支 持 等 。 


2.4 创建 第 一 个 Android 应 用 程序 


2.4.1 


创建 HelloAndroid 工程 


启动 Eclipse， 依 次 选择 File | New | Android Project， 将 会 出 现 如 图 2.11 所 示 的 界面 。 在 
Project name 中 输入 项 目 名 称 ， 单 击 Next， 选 择 Build Target 为 “Android 4.0”， 再 次 单 击 
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Next， 确 定 包 名 为 “introduction.Android.helloAndroid”， 单 击 Finish. Eclipse 会 自动 创建 
Android 工程 HelloAndroid. 


国 New aiad projet | 
Create Android Project 
Select project name and type cf project 


Project Name: HelloAndroid 

@ Create new project in workspace 

C) Create project from existing source 
Create project from existing sample 


E Use defaut location 


QJworkspace/HeloAndroid 
Working sets 
Fl Add project to working sets 


2.1 创建 HelloAndroid 工程 


2.4.2 ”编写 代码 


双击 HelloAndroid 工程 中 的 HelloAndroidActivityjava， 该 文件 中 已 有 程序 代码 如 下 : 


package introduction.Android.helloAndroid; 


import Android.app.Activity; 
import Android.os.Bundle; 


public class HelloAndroidActivity extends Activity { 
/** Called when the activity is first created. */ 
@override 
public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState) ; 
setContentView (R.layout.main) ; 


} 


HelloAndroidActivity.java 这 几 行 代码 比较 简单 ， 表 明 类 HelloAndroidActivity 继承 了 
Activity 类 ， T onCreate() 方 法 ， 在 方法 体 中 调用 了 父 类 的 onCreate0 方 法 ， 然 后 调用 
setContentView0 方 法 显示 视图 界面 。Android 工程 中 使 用 xml 文件 来 设计 视图 界面 ， 
R.layout.main 是 Android 工程 中 默认 的 布局 文件 的 名 字 ， 即 main.xml. 

main.xml 的 内 容 如 下 : 
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<?xml version="1.0" encoding-"utf-8"?» 
<LinearLayout 
xmlns : Android="http: //schemas .Android.com/apk/res/Android" 
Android: layout_width="fill_parent" 
Android:layout height-"fill parent" 
Android:orientation-"'vertical"» 
«TextView 
Android:layout width-"fill parent" 
Android:layout height-"wrap content" 
Android:text-"Gstring/hello" /> 
«/LinearLayout» 


该 文件 中 的 代码 表示 当前 的 布局 文件 使 用 LinearLayout 布局 ， 该 布局 中 仅 有 


个 


TextView 组 件 用 于 显示 信息 ， 显 示 的 内 容 由 "@string/hello" 指 定 。"@string/hello" 指 的 是 资源 


文件 中 values/strings.xml 中 定义 的 hello 字符 串 。strings.xml 中 的 内 容 如 下 : 


<?xml version="1.0" encoding="utf-8"?> 
<resources> 
<string name="hello">Hello Android!</string> 
<string name="app_name">HelloAndroid</string> 
</resources> 


由 该 文件 可 见 ，hello 字符 串 的 内 容 为 “Hello Android!” . 


2.4.3 ”运行 应 用 程序 


CXXov 选择 HelloAndroid 项 目 文件 ， 右 键 单 击 工程 ， 在 弹出 菜单 中 依次 选择 Run As 


| Android Application 命令 ， 出 现 如 图 2.12 所 示 的 Android 虚拟 设备 AVD 界面 。 
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B 10:30 


Android 


[ei cle lv la nlv |. [oo] 
[imel [| | | 


图 2.12 Android 虚拟 设备 AVD 界面 
Eo 选择 并 运行 编写 的 应 用 程序 ， 出 现 如 图 2.13 所 示 的 HelloAndroid 应 用 程序 界面 。 


oon 0 


eGo 
Ocoee 


mum 


I 
eis e je iv lo inj. fe 
^u m n | 


图 2.13 3& f] HelloAndroid 应 用 程序 界面 


2.4.4 ”工程 文件 结构 解析 


没有 书写 一 句 程序 代码 ， 一 个 Android 应 用 便 创 建成 功 了 ,但 是 这 只 是 一 个 简单 的 
Android 应 用 ， 要 创建 更 多 的 Android 应 用 ， 还 要 详细 地 了 解 Android 应 用 程序 结构 。 
Android 工程 文件 结构 如 图 2.14 所 示 。 
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E HelloAndroid 
@ src 
Æ introduction.android.helloAndroid 
[ HelloAndroidActivityjava 
© HelloAndroidActivity 
@ onCreate(Bundle) : void 
名 gen [Generated Java Files] 
E introduction.android.helloAndroid 
D Rjava 
BA Android 4.0 
& assets 
& bin 
& res 
© drawable-hdpi 
© drawable-ldpi 
© drawable-mdpi 
@ layout 
四 main.xml 
© values 
D strings.xml 
回 AndroidManifest.xml 
B proguard.cfg 
project.properties 


图 2.14 Android 工程 文件 结构 


下 面 分 别 介绍 各 个 目录 或 文件 的 作用 。 


src, KAR (RHA) 中 包含 应 用 程序 的 所 有 源 代码 。 在 sre 文件 夹 中 可 以 创建 若干 
Java 包 ， 在 包 中 可 以 创建 应 用 的 处 理 遇 辑 以 及 应 用 的 Activity, A 2.14 中 的 
“HelloAndroidActivity.java” 就 是 在 创建 项 目的 时 候 创建 的 一 个 Activity， 在 Activity 
中 可 以 编写 控制 View 的 逻辑 。 
Android 4.0。 该 目录 (XR) 中 放 的 是 当前 工程 使 用 的 Android SDK。 图 2.14 中 表 
示 当 前 项 目 引 用 的 是 Android SDK 4.0， 不 同 版 本 的 SDK 这 个 文件 的 名 会 不 同 。 
gen. HAR (XE X) 的 Java 包 中 有 一 个 “Rjava” 文 件 。 及 类 中 包含 了 四 个 静态 内 
部 类 : attr, drawable, layout 和 string， 分 别 代表 了 属性 、 图 片 资源 、 布 局 文件 及 字 
符 串 的 声明 。R.java 文 件 是 资源 索引 类 ， 由 Eclipse 自动 生成 的 ， 开 发 者 不 用 去 修改 和 
维护 里 面 的 内 容 ， 但 是 这 个 文件 却 非常 有 用 ， 它 和 res 文件 夹 紧 密 相连 ， 对 res FH 
源 的 操作 都 会 导致 Rjava 文件 的 重新 编译 。Rjava 中 定义 的 常量 类 也 是 间接 帮助 
Activity 完成 对 资源 的 应 用 。Android 这 样 设计 的 好 处 ， 就 是 使 得 复杂 的 资源 通过 专门 
的 类 来 管理 而 让 程序 中 的 代码 变 得 整齐 ， 强 壮 ， 并 且 减 少 了 程序 出 错 和 bug 的 产生 。 
assets, HAR (KRHA) 中 通常 放置 一 些 原始 资源 文件 ， 它 会 在 Android 打包 的 时 候 
原封 不 动 地 一 起 打包 ， 安 装 时 会 直接 解压 到 对 应 的 assets 目录 中 。 这 里 通常 放置 一 些 
项 目 中 用 到 的 多 媒体 资源 等 。 
res. AR (XR) 中 放置 的 是 Android 要 用 到 的 各 种 程序 资源 。 其 中 常见 的 子 文件 
ŻA drawable. layout. values SF. EYP, drawable 目录 放置 应 用 到 的 图 片 资源 ; 
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layout 目录 放置 一 些 与 UI 相关 的 布局 文件 ， 都 是 以 xml 文 件 方式 保存 ; values 目录 中 
放置 的 是 一 些 字符 串 、 数 组 、 闫 色 、 样 式 和 动画 等 资源 ，values 目录 中 的 每 一 个 文件 
都 会 转化 成 Rjava 中 的 一 个 静态 类 ， 文件 中 的 每 一 个 资源 都 会 转化 成 Rjava 中 对 应 静 
态 类 的 静态 整 型 常量 ， 这 样 Activiy 中 通过 一 个 解析 器 就 可 以 获取 到 对 应 的 资源 。 

* AndroidManifest.xml。 这 个 文件 是 整个 项 目的 配置 资源 ， 里 面 配置 的 内 容 包 括 当 前 应 
用 程序 所 在 的 包 、 应 用 程序 中 的 Activity、 应 用 程序 的 访问 权限 等 。 

* default.properties。 这 个 文件 中 记录 了 Android 项 目 运 行 时 的 环境 信息 以 及 Android 
SDK 的 版 本 信息 。 

* pioguard.cfg。 该 文件 为 Android 提供 了 混 消 代 码 工具 proguard 的 配置 文件 。 


2.5 调试 程序 


2.5.1 ”设置 断 点 


设置 断 点 检查 每 个 变量 的 运行 输出 更 适合 一 些 大 型 项 目的 排 错 或 状态 检测 ， 是 Java 开发 
中 不 可 缺少 的 调试 方法 。 

设置 断 点 的 方法 有 两 种 : 

(1) 双击 Eclipse 代码 编辑 区 左边 的 区 域 。 

(2) 在 Android 项 目 中 ， 可 以 通过 在 Eclipse IDE 的 某 行 前 面 单 击 鼠 标 右键 ， 在 弹出 的 快 
捷 菜单 中 选择 Toggle Breakpoint 来 下 断 点 ，Disable Breakpoint 或 Remove Breakpoint 用 来 禁用 
或 移 除 断 点 ， 具 体操 作 如 图 2.15 所 示 。 


public class HelloAndroidActivity 
/** Called when the activity i 
Boverride 
public void onCreate(Bundle sa 


245 设置 断 点 
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2.5.2 ”调试 


通过 单 击 工具 栏 上 的 按钮 ， 或 者 在 项 目 上 单 击 鼠 标 右键 然后 选择 Debug As | Android 


Application 菜单 命令 ， 启 动 程序 的 调试 模式 。 


当 程 序 运 行 到 设置 的 断 点 时 就 会 停 下 ， 这 时 可 以 按照 下 面 的 功能 键 按 需 求 进行 调试 : 


快捷 键 (F8) 直接 执行 程序 ， 直 到 下 一 个 断 点 处 停止 。 
快捷 键 (F5) 单 步 执行 程序 ， 遇 到 方法 时 进入 。 
快捷 键 (F6) 单 步 执行 程序 ， 遇 到 方法 时 跳 过 。 
快捷 键 (F7) 单 步 执行 程序 ， 从 当前 方法 跳出 。 


右键 单 击 对 应 的 变量 ， 在 菜单 上 选择 watch 菜单 项 ， 变 量 的 值 就 会 出 现在 expressions 窗 


口中 ， 这 样 就 可 以 查看 运行 至 断 点 时 变量 当前 的 值 ， 调 试 界面 如 图 2.16 所 示 。 
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小 结 


本 章节 主要 介绍 了 Android 开发 环境 的 搭建 ， 并 以 HelloAndroid 为 例 讲解 了 Android 工 
程 的 创建 过 程 。 Android 工程 文件 结构 主要 包括 sc. gen. res, Android 目录 以 及 
AndroidManifest.xml 文件 ， 每 个 开发 者 都 应 该 熟知 每 个 工程 目录 的 作用 。Android 开发 平台 的 
主要 调试 方法 有 LogCat 以 及 断 点 调试 ， 希 望 读 者 在 日 后 的 学 习 中 能 够 熟悉 应 用 程序 的 调试 方 
法 。 最 后 本 章 还 介绍 了 Android SDK 的 目录 结构 及 其 核心 包 和 扩展 包 。 


思考 题 


1. 尝试 创建 自己 的 第 一 个 Android 工程 。 
2. 请 简要 介绍 Android 工程 中 各 目录 的 作用 。 
3. 谈 谈 你 对 Android SDK 的 认识 。 


Android 应 用 程序 结构 


从 本 章节 可 以 学 习 到 
* 应 用 程序 基本 组 成 

* Activity 

+ 资源 


* AndroidManifest.xml 
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$833 ” Android 应 用 程序 结构 


Android 作为 一 个 移动 设备 的 开发 平台 ， 其 软件 层次 结构 包含 了 一 个 操作 系统 (OS) 、 
中 间 件 CMiddleWare) 和 应 用 程序 (Application) 。 其 中 Android 的 应 用 程序 通常 涉及 用 户 界 
面 和 用 户 交互 ， 这 类 程序 是 用 户 实 实在 在 能 感受 到 的 ， 目 前 Android 本 身 提 供 了 桌面 、 联 系 
人 人、 电话 和 浏览 器 等 众多 的 核心 应 用 ， 同 时 还 允许 开发 者 使 用 应 用 程序 框架 层 的 API 实现 自 
己 的 程序 。 


3.) 应用 程序 基本 组 成 


Android 系统 没有 使 用 常见 的 应 用 程序 入 口 点 的 方法 (例如 main0 方 法 ) ， 应 用 程序 是 由 
组 件 组 成 的 ， 组 件 可 以 调用 相互 独立 的 基本 功能 模块 ， 根 据 完成 的 功能 不 同 ，Android 划分 
了 四 类 核心 组 件 ， 即 Activity, Service, BroadcastReceiver 和 ContentProvider， 各 组 件 之 间 的 
消息 传递 通过 Intent 完成 。 


3.1.1 Activity 

Activity 是 Android 应 用 程序 核心 组 件 中 最 基本 的 一 种 ， 是 用 户 和 应 用 程序 交互 的 窗口 。 
在 Android 应 用 程序 中 ， 一 个 activity 通常 对 应 一 个 单独 的 视图 。 一 个 Android 应 用 程序 是 由 

-个 或 多 个 Activity 组 成 的 ， 这 些 Activity 相当 于 Web 应 用 程序 中 的 网 页 ， 用 于 显示 信息 ， 

并 且 相 互 之 间 可 以 进行 跳 转 。 和 网 页 跳 转 不 同 的 是 ，Activity 之 间 的 跳 转 可 以 有 返回 值 。 

当 新 打开 一 个 视图 时 ， 之 前 的 那个 视图 会 被 署 为 暂停 状态 ， 并 且 压 入 历史 堆栈 中 ， 用 户 
可 以 通过 回 退 操作 返回 到 以 前 打开 过 的 视图 。Activity 是 由 Android 系统 进行 维护 的 ， 它 有 自 
己 的 生命 周期 ， 即 “产生 、 运 行 、 销 毁 ”， 但 是 这 过 程 中 会 调用 许多 方法 ， 如 创建 
onCreate() 、 激 活 onStart() 、 恢 复 onResume(). #f {F onPause0 、 停 止 onStop0 、 销 毁 
onDestroy() 和 重启 onRestart() 等 。 


3.1.2 Service 

Service 是 一 种 类 似 于 Activity 但 是 没有 视图 的 程序 ， 它 没有 用 户 界 面 ， 可 以 在 后 台 运 行 
很 长 的 时 间 ， 相 当 于 操作 系统 中 的 一 个 服务 。Android 定义 了 两 种 类 型 的 Service， 即 本 地 
Service 和 远程 Service。 本 地 Service 是 只 能 由 承载 该 Service 的 应 用 程序 访问 的 组 件 ， 而 远程 
Service 是 供 在 设备 上 运行 的 其 他 应 用 程序 远程 访问 的 Service。 

通过 Context.startService(Intent service) 可 以 启动 一 个 Service， 通 过 Context. bindService() 
可 以 绑 定 一 个 Service. 


3.1.3 BroadcastReceiver 
BroadcastReceiver 也 就 是 “广播 接收 者 ”的 意思 ， 顾 名 思 义 ， 它 就 是 用 来 接收 来 自 系 统 
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和 其 他 应 用 程序 的 广播 ， 并 作出 回应 。 在 Android 系统 中 ， 当 有 特定 事件 发 生 时 就 会 产生 相 
应 的 广播 。 广 播 体现 在 方方面面 ， 例 如 ， 当 开机 过 程 完成 后 系统 会 产生 一 条 广播 ， 接 收 到 这 
条 广播 就 能 实现 开机 启动 服务 的 功能 ; 当 网 络 状态 改变 时 系统 会 产生 一 条 广播 ， 接 收 到 这 条 
广播 就 能 及 时 地 做 出 提示 和 保存 数据 等 操作 ; 当 电池 电量 改变 时 ， 系 统 会 产生 一 条 广播 ， 接 
收 到 这 条 广播 就 能 在 电量 低 时 告知 用 户 及 时 保存 进度 等 。 

BroadcastReceiver 不 能 生成 UI， 通 过 NotificationManager 来 通知 用 户 有 事件 发 生 ， 对 于 
用 户 来 说 是 隐 式 的 。BroadcastReceiver 的 注册 方式 有 两 种 ， 一 种 是 可 以 在 AndroidManifest. 
xml 中 进行 静态 注册 ， 另 一 种 可 以 在 运行 时 的 代码 中 使 用 Context. registerReceiver0 进 行动 态 
注册 。 只 要 注册 了 BroadcastReceiver， 即 使 对 应 的 事件 广播 来 临时 应 用 程序 并 未 启动 ， 系 统 
也 会 自动 启动 该 应 用 程序 对 事件 进行 处 理 。 另 外 ， 用 户 还 可 以 通过 Context.sendBroadcast() 将 
自己 的 Intent 对 象 广播 给 其 他 的 应 用 程序 。 


3.1.4 ContentProvider 

文件 、 数 据 库 等 数据 在 Android 系统 内 是 私有 的 ， 仅 允许 被 特定 应 用 程序 直接 使 用 。 在 
两 个 程序 之 间 数 据 的 交换 或 共享 由 ContentProvider 实现 。 

ContentProvider 类 实现 了 一 组 标准 方法 的 接口 ， 从 而 能 够 让 其 他 的 应 用 保存 或 读 取 
ContentProvider 提供 的 各 种 数据 类 型 。 


3.1.5 Intent 

Intent 并 不 是 Android 应 用 程序 四 大 核心 组 件 之 一 ， 但 是 其 重要 性 无 可 替代 ， 因 此 在 这 里 
我 们 做 一 下 简单 介绍 。 

Android 应 用 程序 核心 组 件 中 的 三 大 核心 组 件 一 一 Activity、Service、BroadcastReceiver， 
通过 消息 机 制 被 启动 激活 ， 而 所 使 用 的 消息 就 是 Intent. Intent 是 对 即将 要 进行 的 操作 的 抽象 
描述 ， 承 担 了 Android 应 用 程序 三 大 核心 组 件 相互 之 间 的 通信 功能 。 


3 . 2 Activity 


Activity 是 Andorid 组 件 中 最 基本 也 是 最 为 常见 的 组 件 。Activity 是 用 户 接口 程序 ， 原 则 
上 它 会 提供 给 用 户 一 个 交互 式 的 接口 功能 ， 几 乎 所 有 的 Activity 都 要 和 用 户 打交道 ， 也 有 人 
把 它 比 喻 成 Android 的 管理 员 。 需 要 在 屏幕 上 显示 什么 ， 用 户 在 屏幕 上 做 什么 ， 处 理 用 户 不 
同 操作 等 都 由 Activity 来 管理 和 调度 。 

Activity 提供 用 户 与 Android 系统 交互 的 接口 ， 用 户 通 过 Activity 来 完成 自己 的 目的 ， 例 
如 打 电 话 、 拍 照 、 发 送 E-mail、 查 看 地 图 等 。 每 个 Activity 都 提供 一 个 用 户 界面 窗口 ， 一 般 
情况 下 ， 该 界面 窗口 会 填 满 整 个 屏幕 ， 但 是 也 可 以 比 屏幕 小 ， 或 者 浮 在 其 他 的 窗口 之 上 。 


32 


第 3 章 ”Android 应 用 程序 结构 


一 个 Android 应 用 程序 通常 由 多 个 Activity 组 成 ， 但 是 其 中 只 有 一 个 为 主 Activity， 其 作 
用 相当 于 Java 应 用 程序 中 的 main 函数 ， 当 应 用 程序 启动 时 ， 作 为 应 用 程序 的 入 口 首先 呈现 
给 用 户 。Android 应 用 程序 中 的 多 个 Activity 直接 可 以 相互 调用 以 完成 不 同 工 作 。 当 新 的 
Activity 被 启动 的 时 候 ， 之 前 的 Activity 会 被 停止 ， 但 是 不 会 被 销毁 ， 而 是 被 压 入 到 “后 退 栈 
(Back Stack) ”的 栈 项 ， 而 新 启动 的 Activity 获得 焦点 ， 显 示 给 用 户 。“ 后 退 栈 ” 遵 循 “后 
入 先 出 ”的 原则 。 当 新 启动 的 Activity 被 使 用 完毕 ， 用 户 单 击 “Back” 按 钮 时 ， 当 前 的 
Activity 会 被 销毁 ， 而 原先 的 Activity 会 被 从 “后 退 栈 ” 的 栈 项 弹出 并 且 激 活 。 

当 Activity 状态 发 生 改 变 时 ， 都 会 通过 状态 回调 函数 通知 Android 系统 。 而 程序 编写 人 
员 可 以 通过 这 些 回调 函数 对 Activity 进行 进一步 的 控制 。 

下 面 对 Activity 生命 周期 及 其 涉及 的 回调 函数 进行 简单 介绍 。 


3.2.4 Activity 的 生命 周期 
从 本 质 上 讲 ，Activity 在 生命 周期 中 共存 在 三 个 状态 ， 分 别 为 : 


© 运行 态 : 运行 态 指 Activity 运 行 于 屏幕 的 最 上 层 并 且 获 得 了 用 户 焦点 。 

e BA: 暂停 态 是 指 当 前 Activity 依然 存在 ， 但 是 没有 获得 用 户 焦点 。 在 其 之 上 有 其 他 
的 Activity 处 于 运行 态 ， 但 是 由 于 处 于 运行 态 的 Activity 没有 遮挡 住 整 个 屏幕 ， 当 前 
Activity 有 一 部 分 视图 可 以 被 用 户 看 见 。 处 于 暂停 态 的 Activity 保留 了 自己 所 使 用 的 内 
存 和 用 户 信息 ， 但 是 在 当 系统 极 度 缺 乏 资 源 的 情况 下 ， 有 可 能 会 被 杀 死 以 释放 资源 。 

e 停止 态 : 停止 态 是 指 当前 Activity 完全 被 处 于 运行 态 的 Activity HAE, HAP Ri 
完全 不 能 被 用 户 看 见 。 处 于 停止 态 的 Activity 依然 存活 ， 也 保留 了 自己 所 使 用 的 内 存 
和 用 户 信 息 ， 但 是 一 旦 系统 缺乏 资源 ， 停 止 态 的 Activity 就 会 被 杀 死 以 释放 资源 。 


Activity 在 声明 周期 中 从 一 种 状态 到 另 一 种 状态 时 会 激发 相应 的 回调 方法 ， 这 些 回调 方法 
包括 : 


© onCreate ( Bundle savedInstanceState) 。 创 建 activity 时 调用 。 设 置 在 该 方法 中 ， 还 以 
Bundle 的 形式 提供 对 以 前 储存 的 任何 状态 的 访问 。 其 中 参数 savedInstanceState 对 象 是 
用 于 保存 Activity 的 对 象 的 状态 。 

© onStart(). activity 变 为 在 屏幕 上 对 用 户 可 见 时 调用 。 

* onResume(). Activity 开始 与 用 户 交互 时 调用 (无 论 是 启动 还 是 重启 一 个 活动 ， 该 方 
法 总 是 被 调用 的 ) 。 

© onPause()。 当 Android 系统 要 激活 其 他 Activity 时 ， 该 方法 被 调用 ， 暂 停 或 收回 CPU 
和 其 他 资源 时 调用 。 

© onStop(. Activity 被 停止 并 转 为 不 可 见 阶段 时 调用 。 

* onRestart()。 重 新 启动 已 经 停止 的 Activity 时 调用 。 

© onDestroy(). Activity 被 完全 从 系统 内 存 中 移 除 时 调用 ， 该 方法 被 调用 可 能 是 因为 有 
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人 直接 调用 finish0 方 法 或 者 系统 决定 停止 该 活动 以 释放 资源 。 
上 面 7 个 生命 周期 方法 分 别 在 4 个 阶段 按 着 一 定 的 顺序 进行 调用 ， 这 4 个 阶段 如 下 : 
© 启动 Activity。 在 这 个 阶段 依次 执行 3 个 生命 周期 方法 : onCreate、onStart 和 onResume, 


onRestart, onStart 和 onResume。 
e 关闭 Activity。 当 Activity 被 关闭 时 系统 会 依次 执行 3 个 生命 周期 方法 : onPause、 
onStop 和 onDestroy。 


Activity 生命 周期 中 方法 调用 过 程 如 图 3.1 所 示 。 


3.1 Activity 生命 周期 


通过 图 3.1， 可 以 很 直观 了 解 到 activity 的 整个 生命 过 程 。Activity 的 生命 过 程 表现 在 三 个 
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层面 ， 如 图 3.2 所 示 。 
Activity 的 整个 生命 周期 


onCreate() 整个 生命 周期 


onRestart() 可 见 阶段 


前 台阶 段 
onStart() 
onResume() 


onPause() 


onStop() 


onDestroy() 


3.2 Activity 的 整个 生命 周期 
通过 图 3.2 可 以 更 清楚 地 了 解 Activity 的 运行 机 制 。 如 果 Activity 离开 了 可 见 阶段 ， 长 时 
间 失 去 了 焦点 ，Activity 就 很 可 能 被 系统 销毁 以 释放 资源 。 当 然 ， 即 使 该 Activity 被 销毁 掉 ， 
用 户 对 该 Activity 所 做 的 更 改 也 会 被 保存 在 Bundle 对 象 中 ， 当 用 户 需要 重新 显示 该 Activity 
时 ，Android 系统 会 根据 之 前 保存 的 用 户 更 改 信息 将 该 Activity 重建 。 


3.2.2 Activity 的 创建 
在 一 个 Android 工程 中 ， 创 建 Activity 的 步骤 如 下 : 
HO) 新 建 类 。 创建 一 个 Activity， 必 须 创建 Android.app.Activity ( 或 者 它 的 一 个 已 经 存 
在 的 子 类 ) 的 一 个 子 类 ， 并 重 写 onCreate() 方 法 。 
Eo 关联 布局 xml 文 件 。 在 新 建 的 Activity 中 设置 其 布局 方式 ， 需 要 在 res/layout 目录 中 
新 建 一 个 xml 布 局 文件 ， 可 以 通过 setContentView(0 来 指定 Activity 的 用 户 界面 的 布 
局 文件 。 
人 EXO3 注册 。 在 AndroidManifestxml 文件 中 对 建立 的 Activity 进行 注册 ， 即 在 
<application> 标 签 下 添加 <activity> 标 签 。 例 如 ， 注 册 ExampleActivity 的 代码 如 下 : 
<application ...> 
<activity Android:name=".ExampleActivity" /> 
aoi eain A 


对 于 主 Activity， 要 为 其 添加 <intent-filter> 标 签 。 代 码 如 下 : 
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«activity Android:name-".ExampleActivity" 
Android:icon-"G(drawable/app icon"» 
<intent-filter> 
<action Android:name="Android.intent.action.MAIN" /> 
«category Android:name-"Android.intent.category.LAUNCHER" /> 
</intent-filter> 
</activity> 


其 中 <action Android:name-"Android.intent.action. MAIN" /> 表示 该 Activity 作为 主 Activity 


出 现 ， 而 <category Android:name="Android.intent.category.LAUNCHER" /> 表示 该 Activity 会 被 
显示 在 最 上 层 的 启动 列表 中 。 


3.2.3 ”启动 Activity 


在 Android 系 统 中 ， 除 主 Activity 由 系统 启动 ， 其 他 Activity 都 要 由 应 用 程序 来 启动 。 
CD 通常 情况 下 ， 通 过 startActivity0 方 法 来 启动 Activity， 而 要 启动 的 Activity 的 信息 由 
Intent 对 象 来 传递 。 例 如 : 


Intent intent=new Intent (this, AnotherActivity.class) ; 
startActivity (intent) ; 


表示 通过 当前 的 Activity 启动 名 为 AnotherActivity 的 Activity. 

有 时 ， 用 户 不 需要 知道 要 启动 的 Activity 的 名 字 ， 而 可 以 仅 制定 要 完成 的 行为 ， 由 
Android 系统 来 为 用 户 挑选 合适 的 Activity。 例 如 : 

Intent intent=new Intent (Intent.ACTION_SEND) ; 


intent.putExtra (Intent.EXTRA_EMAIL, recipientArray) ; 
startActivity (intent) ; 


其 中 Intent. EXTRA_EMAIL 放置 的 是 recipientArray 中 存储 的 要 发 送 的 E-mail 的 目标 地 
Hk. iX Intent MRM startActivityOAA ia, Android 系统 会 启动 相应 的 E-mail 处 理应 用 程序 ， 
并 将 Intent EXTRA_EMAIL 中 的 内 容 放置 到 邮件 的 目标 地 址 中 。 

(2) 有 时 ， 当 需要 从 启动 的 Activity 获取 返回 值 的 时 候 ， 需 要 使 用 startActivityForResult() 
方法 代替 startActivity() 方 法 ， 并 实现 onActivityResult( 方 法 来 获取 返回 值 。 

例如 ， 在 发 送 短信 的 时 候 ， 用 户 需 要 从 联系 人 列表 中 获取 联系 人 的 信息 ， 然 后 返回 到 短 
信 发 送 界面 。 代 码 如 下 : 

Intent intent-new Intent (Intent.ACTION PICK, Contacts.CONTENT URI) ; 

startActivityForResult (intent, PICK CONTACT REQUEST) ; 


当 用 户 选择 了 联系 人 后 ， 相 关 信息 会 被 存储 到 Intent 对 象 中 ， 并 返回 到 onActivityResult() 
方法 中 。 
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3.24 XH] Activity 


关闭 Activity 使 用 finish0 方 法 。 关 闭 之 前 启动 的 其 他 Activity 可 以 使 用 finishActivity0 方 

需要 注意 的 是 ， 虽 然 Android SDK 提供 了 关闭 Activity 的 方法 ， 但 是 通常 情况 下 ， 程 序 
员 不 应 该 使 用 这 些 方法 去 强制 关闭 Activity。 因 为 Android 系统 在 为 用 户 维 护 Activity 的 生命 
周期 ， 并 且 提 供 了 完备 的 资源 回收 机 制 和 资源 重建 机 制 ， 可 以 动态 地 回收 和 重建 Activity， 
因此 Activity 应 用 交 由 Android 系统 来 管理 ， 除 非 已 确定 用 户 不 再 需要 当前 的 Activity, JF B. 
不 允许 用 户 回 退 到 当前 Activity。 


3.2.5 Activity 数据 传递 
Activity 数据 传递 共有 三 种 : 


e 通过 intent 传递 一 些 简单 的 数据 。 

o 通过 Bundle 传递 相对 复杂 的 数据 或 者 对 象 。 

© 通过 startActivityForResult 可 以 更 方便 地 进行 来 回 的 传递 ， 当 然 前 两 种 方法 也 可 以 来 
回 传递 。 


假设 由 Activity] 向 Activity2 传递 数据 ， 利 用 三 种 方式 实现 的 实例 代码 如 下 。 
(1) 利用 Intent 传递 数据 。 

在 传递 数据 的 Activityl 中 : 

Intent intent=new Intent (Activityl.this,Activity2.class) ; 
intent.putExtra ("author","leebo") ;// 在 Intent 中 加 入 键 值 对 数据 ， 键 为 


“author”， 值 为 “leebo” 
Activityl.this.startActivity (intent) ; 


在 取出 数据 的 Activity2 rf: 


Intent intent=getIntent () ;// 获 得 传 过 来 的 Intent, 
String value=intent.getStringExtra ("author") ; 


// 根 据 键 名 author 取出 对 应 键 值 为 “leebo” 


(2) 利用 Bundle 传递 数据 。 

在 传递 数据 的 Activity] 中 : 

Intent intent-new Intent (Activityl.this,Activity2.class) ; 
Bundle myBundle-new Bundle(); 

myBundle.putString ("author","leebo") ; 


intent.putExtras (myBundle) ; 
Activityl.this.startActivity (intent) ; 
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在 取出 数据 的 Activity2 中 : 


Intent intent-getIntent(); 

Bundle myBundle-intent.getExtras(); 

String value-myBundle.getString ("author") ; // 根 据 键 名 author 取出 对 应 键 值 为 
“leebo” 


(3) 利用 startActivityForResult() 传 递 数据 。 
startActivityForResult() 方 法 不 但 可 以 把 数据 从 Activity] 传递 给 Activity2， 还 可 以 把 数据 
从 Activity2 传 回 给 Activity1。 
在 Activityl 中 : 


final int REQUEST_CODE=1; 

Intent intent-new Intent (Activityl.this,Activity2.class) ; 
Bundle mybundle=new Bundle() ; 

mybundle.putString ("author", "leebo") ;// 把 数据 传 过 去 
intent.putExtras (mybundle) ; 

startActivityForResult (intent, REQUEST_CODE) ; 


重 载 onActivityResult 方 法 ， 用 来 接收 传 过 来 的 数据 (接收 b 中 传 过 来 的 数据 ) : 


protected void onActivityResult (int requestCode, int 
resultCode, Intent intent) { 
if (requestCode==this.REQUEST_CODE) { 
switch (resultCode) { 
case RESULT_OK: 
Bundle b-intent.getExtras(); 
String str-b.getString ("Result") ; // 获 取 到 Result 中 的 值 ， 为 “from 
Activity2” 
break; 
default: 
break; 


在 Activity2 中 : 


Intent intent-getIntent(); 

Bundle myBundle-getIntent ().getExtras(); 
String author-getBundle.getString ("author") ; 
Intent intent-new Intent(); 

Bundle bundle-new Bundle(); 

bundle.putString ("Result","from Activity2") ; 
intent.putExtras (bundle) ; 
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Activity02.this.setResult ( RESULT OK,ntent) /通过 intent 将 数据 返回 给 Activityl , 
RESULT OK 是 结果 码 : 


finish();// 结 束 当前 的 Activity。 


本 质 上 ， 这 三 种 数据 传递 方式 都 是 通过 Intent 来 完成 的 。 


3.3 资源 


在 Android 层次 结构 中 ， 资 源 扮演 着 重要 的 角色 。Android 支持 字符 串 、 位 图 以 及 其 他 很 
多 种 类 型 的 资源 。 每 一 种 资源 的 语法 、 格 式 以 及 存放 的 位 置 ， 都 会 根据 其 类 型 的 不 同 而 不 
同 。 一 般 来 讲 共有 三 种 类 型 的 资源 文件 ， XML 文件 、 位 图 文件 〈 图 像 ) 和 raw 文件 (声音 
Bs 

Android 工程 目录 中 ， 用 于 存放 资源 文件 的 有 两 个 文件 夹 ， 分 别 为 res 和 assets. H res 
文件 夹 不 支持 深度 子 目 录 ， 其 中 的 资源 最 终 将 被 打包 到 编译 后 java 文件 中 ， 可 以 直接 通过 R 
资源 类 访问 ， 利 用 率 较 高 ， 而 assets 中 存放 的 资源 是 用 于 打包 到 应 用 程序 中 的 静态 文件 ， 这 
些 文件 不 会 被 编译 ， 最 终 会 直接 部 署 到 目标 设备 中 ， 可 以 使 用 任意 深度 的 子 目录 进行 存储 。 
assets 文件 夹 中 的 文件 不 能 直接 通过 资源 类 R 读 取 ， 只 能 使 用 流 的 形式 读 取 ， 其 利用 率 相对 
较 低 。 

Android 的 资源 编译 器 AAPT (Android Asset Packaging Tool) 会 依照 资源 所 在 的 子 目 录 
及 其 格式 对 其 进行 编译 。 


3 4 AndroidManifest.xml 


每 一 个 Android 项 目 都 包含 一 个 清单 (Manifest) 文件 AndroidManifest.xml， 它 是 XML 
格式 的 Android 程序 声明 文件 ， 包 含 了 Android 系统 运行 程序 前 所 必须 掌握 的 重要 信息 ， 这 
些 信息 包含 应 用 程序 名 称 、 图 标 、 包 名 称 、 模 块 组 成 、 授 权 和 SDK 最 低 版 本 等 ， 而 且 每 个 
Android 程序 必须 在 根 目 录 下 包含 一 个 AndroidManifest.xml. 

AndroidManifestxml 中 可 包含 的 所 有 标签 元 素 如 以 下 代码 所 示 ， 其 中 除了 <manifest> 和 
<application> 标 签 是 必需 的 ， 其 他 所 有 标签 都 可 按 情 况 添加 。 

<?xml version="1.0" encoding-"utf-8"?» 

<manifest> 


<uses-permission /> 
<permission /> 
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<permission-tree /> 
<permission-group /> 
<instrumentation /> 
<uses-sdk /> 
<uses-configuration /> 
<uses-feature /> 
<supports-screens /> 
<compatible-screens /> 
<supports-gl-texture /> 
<application> 
<activity> 
<intent-filter> 
<action /> 
<category /> 
<data /> 
</intent-filter> 
<meta-data /> 
</activity> 
<activity-alias> 
<intent-filter>. . .</intent-filter> 
<meta-data /> 
</activity-alias> 
<service> 
<intent-filter>. . .</intent-filter> 
<meta-data/> 
</service> 
<receiver> 
<intent-filter>. . .</intent-filter> 
<meta-data /> 
</receiver> 
<provider> 
<grant-uri-permission /> 
<meta-data /> 
</provider> 
<uses-library /> 
</application> 
</manifest> 


在 此 ， 仅 对 几 种 常见 的 标签 进行 简单 介绍 。 

(1) manifest 标签 

manifest 标签 是 AndroidManifest.xml 文件 的 根 标签 ， 该 标签 用 于 设置 与 项 目 相关 的 一 些 
属性 ， 比 如 用 于 唯一 标识 应 用 程序 的 package 属性 ， 用 于 记录 应 用 程序 版 本 的 
Android:versionName 属性 等 。 其 中 的 xmlns:Android 属性 必须 被 定义 为 : “http://schemas. 
Android.com/apk/res/Android" 。 
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(2) application 标签 

manifest 标签 仅 能 包含 一 个 application 标签 ， 它 使 用 各 种 属性 来 指定 应 用 程序 的 各 种 元 
数据 (包括 标题 、 图 标 和 主题 ) 。 它 还 可 以 作为 一 个 包含 了 活动 Activity) 、 服 务 
(Service) 、 内 容 提供 器 (Provider) 和 广播 接收 器 (BroadcastReceiver) 标签 的 容器 ， 用 来 指 
定 应 用 程序 组 件 。 


© activity 标签 。 应 用 程序 显示 的 每 一 个 Activity 都 要 求 有 一 个 activity 标签 ， 并 使 用 
Android:name 属性 来 指定 类 的 名 称 。 这 必须 包含 核心 的 启动 Activity 和 其 他 所 有 可 以 
显示 的 屏幕 或 者 对 话 框 。 启 动 任何 一 个 没有 在 清单 中 定义 的 Activity 时 都 会 抛 出 一 个 
运行 时 异常 。 每 一 个 Activity 节点 都 允许 使 用 intent-filter 子 标签 来 指定 哪个 Intent È 
动 该 活动 。 

© service 标签 。 和 activity 标签 一 样 ， 应 用 程序 中 使 用 的 每 一 个 Service 类 都 要 创建 一 个 
新 的 service 标签 。 ( Service 标签 也 支持 使 用 intent-filter 子 标签 来 允许 后 面 的 运行 时 
dE.) 

© provider 4&4, provider 标签 用 来 说 明 应 用 程序 中 的 每 一 个 内 容 提供 器 。 内 容 提供 器 是 
用 来 管理 数据 库 访 问 以 及 程序 内 和 程序 间 共 享 的 ， 第 6 章 将 会 对 其 进行 详细 讲述 。 

* receiver 标签 。 通 过 添加 receiver 标签 ， 可 以 注册 一 个 广播 接收 器 ( Broadcast 
Receiver) ， 而 不 用 事先 启动 应 用 程序 。 广播 接收 器 就 像 全 局 事件 监听 器 一 样 ， 一 旦 
注册 了 之 后 ， 无 论 何 时 ， 只 要 与 它 相 匹配 的 intent 被 应 用 程序 广播 出 来 ， 它 就 会 立即 
执行 。 通 过 在 声明 中 注册 一 个 广播 接收 器 ， 可 以 使 这 个 进程 实现 完全 自动 化 。 如 果 一 
个 匹配 的 Intent 被 广播 了 ， 则 应 用 程序 就 会 自动 启动 ， 并 且 你 注册 的 广播 接收 器 也 会 
开始 运行 。 


(3) uses-permission 标签 

作为 安全 模型 的 一 部 分 ，uses-permission 标签 声明 了 那些 自己 定义 的 权限 ， 而 这 些 权限 
是 应 用 程序 正常 执行 所 必需 的 。 在 安装 程序 时 ， 设 定 的 所 有 权限 将 会 告诉 给 用 户 ， 由 他 们 来 
决定 同意 与 否 。 对 很 多 本 地 Android 服务 来 说 ， 权 限 都 是 必需 的 ， 特 别 是 那些 需要 付费 或 者 
有 安全 问题 的 服务 〈 例 如 ， 拨 号 、 接 收 SMS 或 者 使 用 基于 位 置 的 服务 ) 。 第 三 方 应 用 程序 ， 
包括 你 自己 的 应 用 程序 ， 也 可 以 在 提供 对 共享 的 程序 组 件 进行 访问 之 前 指定 权限 。 

(4) permission 标签 

在 可 以 限制 访问 某 个 应 用 程序 组 件 之 前 ， 需 要 在 清单 中 定义 一 个 permission. "f LE HH 
permission 标签 来 创建 这 些 权 限定 义 。 然 后 ， 应 用 程序 组 件 就 可 以 通过 添加 Android: 
permission 属性 来 要 求 这 些 权 限 。 其 他 的 应 用 程序 就 需要 在 它们 的 清单 中 包含 uses-permission 
标签 (并 且 通 过 授权 ) ， 之 后 才能 使 用 这 些 受 保护 的 组 件 。 在 permission 标签 内 ， 可 以 详细 
指定 允许 的 访问 权限 的 级 别 (normal、dangerous、signature，signatureOrSystem) 、 一 个 label 
属性 和 一 个 外 部 资源 ， 这 个 外 部 资源 应 该 包含 了 对 授予 这 种 权限 的 风险 的 描述 。 

(5) instrumentation 标签 

Instrumentation 类 提供 一 个 框架 ， 用 来 在 应 用 程序 运行 时 在 活动 或 者 服务 上 运行 测试 。 
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它们 提供 了 一 些 方法 来 监控 应 用 程序 及 其 与 系统 资源 的 交互 。 对 于 为 自己 的 应 用 程序 所 创建 
的 每 一 个 测试 类 ， 都 需要 创建 一 个 新 的 节点 。 


3.5 小 结 


(1) Android 应 用 程序 基本 组 成 包括 Activity、Service、BroadcastReceiver、ContentProvider、 
Intent。 

(2) Activity 的 创建 、 生 命 周 期 以 及 之 间 数 据 传递 的 方法 。 

(3) Android 资源 的 创建 以 及 使 用 ，AndroidManifest.xml 定义 应 用 程序 及 其 组 件 的 结构 和 


3.6 思考 题 


1. 简 述 Activity 的 生命 周期 。 

2. 比较 Activity 之 间 数 据 传递 三 种 方法 的 优 缺 点 。 

3. 尝试 创建 自己 的 Activity， 并 进行 数据 传递 。 

4. Android 应 用 程序 的 四 大 组 件 是 什么 ? 分 别 有 什 么 作用 ? 


42 


用 户 界 面 开 发 


从 本 章节 可 以 学 习 到 : 


“ View 和 ViewGroup 
学 使 用 XML 定义 视图 
* 布局 

学 常用 Widget 组 件 
* Menu 和 ActionBar 
* Bitmap 

* 对话 框 (Dialog) 

学 Toast 和 Notification 
学 界面 事件 响应 
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Andriod 系统 提供 了 丰富 的 可 视 化 界面 组 件 ， 包 括 菜单 、 按 钮 、 对 话 框 等 等 。Andriod 系 
统 采用 Java 程 序 设计 中 的 UI 设计 思想 ， 其 中 包括 事件 处 理 机 制 及 布局 管理 方式 。Android 系 
统 中 的 所 有 UI 类 都 是 建立 在 View 和 ViewGroup 两 个 类 的 基础 之 上 的 ， 所 有 View 的 子 类 称 
为 Widget， 所 有 ViewGroup 的 子 类 称 为 Layout。 本 章 将 详细 介绍 Android 4.0 的 基础 功能 单 
元 一 一 Activity 的 用 户 界面 UI 设计、 用户 界面 UI 组 件 及 其 事件 处 理 的 相关 知识 。 


4 ] View 和 ViewGroup 


Activity 是 Android 应 用 程序 与 用 户 交 互 的 接口 ， 每 一 个 屏幕 视图 都 对 应 一 个 Activity。 
其 实 Activity 本 身 无 法 显示 在 屏幕 上 ， 其 更 像 一 个 用 于 装载 可 显示 组 件 的 容器 。 这 就 好 比 一 
个 ISP 页 面 ， 它 本 身 并 没有 显示 出 来 任何 东西 ， 负 责 显示 的 是 ISP 页 面 内 的 各 种 HTML 标 
签 ， 而 ISP 页 面 好 比 一 个 容器 ， 负 责 将 这 些 表情 装载 到 页 面 内 。 那 么 在 Android 应 用 程序 里 
谁 才 是 真正 负责 显示 的 那 部 分 呢 ? 答案 是 View 和 ViewGroup， 其 中 ViewGroup 是 View 的 子 

Android UI 界面 是 通过 View 〈 视 图) 和 ViewGroup 及 其 派生 类 组 合 而 成 的 。 其 中 View 
是 所 有 UI 组件 的 基 类 ， 基 本 上 所 有 的 高 级 UI 组 件 都 是 继承 View 类 实现 ， 如 TextView ( 文 
ASHE) . Button. List. EditText (编辑 框 )、Checkbox 等 。 一 个 View 在 屏幕 占据 一 块 矩形 
区 域 ， 他 负责 渔 染 这 块 矩 形 区域 ， 也 可 以 处 理 这 块 矩 形 区 域 发 生 的 事件 ， 并 可 以 设置 该 区 域 
是 否 可 见 以 及 获取 焦点 等 ; 而 ViewGroup 是 容纳 这 些 组 件 的 容器 ， 其 本 身 也 是 从 View 中 派 
生出 来 的 ， 它 继承 于 Android.viewView， 它 的 功能 就 是 装载 和 管理 下 一 层 的 View 对 象 或 
ViewGroup 对 象 ， 也 就 是 说 它 是 一 个 容纳 其 他 元 素 的 容器 ， 负 责 对 添加 进来 的 View 和 
ViewGroup 进行 管理 和 布局 。View 和 ViewGroup 的 关系 如 图 4.1 所 示 。 


ViewGroup 


public abstract class 


ViewGroup 


extends View 
implements ViewManager ViewParent 


java.lang.Object 
Landroid view.View 
Landroid.view.ViewGroup 


4.1 View 和 ViewGroup 的 关系 图 


从 上 图 可 以 看 到 ，ViewGroup 可 以 包含 一 个 或 任意 个 View 〈 视 图 ) ， 也 可 以 包含 作为 更 
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低层 次 的 子 ViewGroup ， 而 子 ViewGroup 又 可 以 包含 下 一 层 的 叶子 节点 的 view 和 
ViewGroup。 这 种 灵活 的 层次 关系 可 以 形成 复杂 的 UI 布 局 。 在 开发 过 程 中 形成 的 用 户 界面 UI 
一 般 是 来 自 于 View 和 ViewGroup 类 的 直接 子 类 或 者 间接 子 类 。 

例如 ，View 派生 出 的 直接 子 类 有 :，AnalogClock, ImageView, KeyboardView, ProgressBar, 
Space, SurfaceView, TextView, TextureView, ViewGroup, ViewStub 等 。ViewGroup 派生 出 的 直接 
子 类 有 : AbsoluteLayout, FragmentBreadCrumbs, FrameLayout, GridLayout, LinearLayout, 
RelativeLayout, SlidingDrawer 等 。 本 章 不 能 对 View 和 ViewGroup 的 所 有 子 类 都 进行 详细 的 介 
绍 ， 只 能 简单 介绍 其 中 常用 的 一 小 部 分 。 如 果 需 要 了 解 各 UI 组 件 的 相关 信息 ， 请 参考 相关 


文档 。 


Á.) 使 用 XML 定义 视图 


在 使 用 XML 构建 一 个 用 户 界面 之 前 我 们 需要 重 温 一 下 Android 工程 的 目录 结构 。 如 图 
4.2 所 示 ， 以 HelloAndroid 为 例 ， res 目录 为 Android 工程 中 所 使 用 的 资源 目录 ， 用 户 UI 所 涉 


及 的 资源 基本 都 放置 在 该 目录 下 。res 目录 下 的 每 一 项 
资源 文件 都 会 由 aapt (Android Asset Packaging Tool) 

为 其 生成 一 个 对 应 的 public static final 类 型 的 ID 号 ， 放 
置 到 gen 目录 下 的 Rjava 文件 中 ，Android 系统 根据 该 
ID 号 来 访问 对 应 资源 。gen 目录 由 ADT 根据 资源 文件 
自动 生成 ， 不 需要 用 户 修 改 ， 由 系统 维护 。 

res/drawable/ 目录 用 来 存放 工程 中 使 用 到 的 图 片 文件 ， 

drawable 之 后 的 hdpi、ldpi、mdpi 分 别 放 高 分 辨 率 、 低 
分 辨 率 和 中 分 辨 率 的 图 片 以 适应 不 同 分 辩 率 的 手机 。 

Android 系统 会 根据 用 户 手机 的 配置 信息 自动 选取 合适 
分 辨 率 的 图 片 文件 ， 无 须 程序 员 干 预 。res/layout/ 目 录 
下 存放 着 定义 UI 布局 文件 用 的 xml 文件 ， 默 认 文件 名 
为 main.xml; res/values/ 目 录 下 存放 着 用 于 存储 工程 中 
所 使 用 到 的 一 些 字符 串 信 息 的 文件 ， 默 认 文件 名 为 
strings.xml。 当然 ， 每 个 目录 下 都 可 以 存放 多 个 xml X 
件 ， 可 由 开发 者 自行 创建 。 由 此 可 见 ，Android 工程 中 
使 用 的 用 户 UI 设计 ， 以 及 用 户 UI 中 涉及 的 字符 串 都 是 
由 xml 文件 来 存储 的 。Android 系统 使 用 xml 文件 来 定 
义 用 户 视图 。 


E HelloAndroid 


@ src 

Bi introduction.android.helloAndroid 
(3) HelloAndroidActivityjava 
© HelloAndroidActivity 

@ onCreate(Bundle) : void 
E gen [Generated Java Files] 

Æ introduction.android.helloAndroid 
国 Rjava 
BÀ Android 4.0 
ge assets 
& bin 
& res 

(€ drawable-hdpi 

© drawable-Idpi 

@ drawable-mdpi 

@ layout 

四 main.xml 


(£ values 
[Xj strings.xml 
B AndroidManifest.xml 
Bica 
project.properties 
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单 击 打开 values 文件 夹 下 的 string.xml 文件 显示 出 如 下 代码 : 
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<?xml version="1.0" encoding="utf-8"?> 
<resources> 
«string name="hello">Hello Android!</string> 
«string name="app_name">HelloAndroid</string> 
</resources> 


文件 的 开头 部 分 <?xml version="1.0" encoding-"utf-8"?»/: X f xml 的 版 本 号 和 字符 编 
码 ， 这 个 部 分 在 所 有 的 xml 文件 中 都 会 有 ， 由 系统 自动 添加 ， 不 需要 修改 。<resources> 标 签 
定义 了 hello 和 app name 两 个 变量 ， 可 以 被 HelloAndroid 工程 直接 使 用 。 当 该 文件 被 修改 ， 
gen 目录 下 的 Rjava 文 件 也 会 跟随 进行 更 新 。 

双击 main.xml 文件 ， 代 码 如 下 : 


<?xml version-"1.0" encoding-"utf-8"?» 
«LinearLayout 
xmlns:android-"http://schemas.android.com/apk/res/android" 
android:layout width-"fill parent" 
android:layout height-"fill parent" 
android:orientation-"vertical"» 
«TextView 
android:id-"eid/textViewl" 
android:layout width-"fill parent" 
android:layout height- "wrap content" 
android:text-"estring/hello" /> 
«/LinearLayout» 


<LinearLayout> 标 签 定义 了 当前 视图 使 用 的 是 LinearLayout 布局 ， 也 叫做 线性 布局 方式 ， 
这 种 也 是 最 常用 的 布局 方式 ，Android SDK 还 提供 其 他 的 几 种 布局 方式 ， 我 们 会 在 后 面 的 章 
节 中 进行 详细 的 介绍 。 在 <LinearLayout> 标 签 中 定义 了 该 布局 方式 的 相关 属性 android: 
layout width="fill parent" 和 android:layout height-"fill parent" 表 示 该 布局 的 宽 和 高 充满 整个 手 
机 屏幕 ，android:orientation="vertical" 表 示 该 布局 中 所 放 入 的 组 件 的 排列 方式 为 纵向 排列 。 

在 <LinearLayout .…> 和 </LinearLayout> 之 间 就 可 以 添加 各 种 UI 组 件 并 设置 组 件 的 相关 属 
性 ， 例 如 组 件 的 高 度 、 宽 度 、 组 件 的 内 容 等 ， 在 本 章 第 四 节 会 详细 介绍 各 种 常见 组 件 的 使 用 
方法 。 在 HelloAndroid 实例 中 添加 的 是 一 个 TextView 组 件 ， 相 当 于 一 个 显示 内 容 的 标签 。 
android:layout_width="fill_parent" 指定 其 宽度 覆盖 满 容器 的 宽 ，android:layout height- 
"wrap_content" 指 定 其 高 度 跟 随 其 显示 内 容 变 化 。android:id="@id/textView1" 指 明 该 TextView 
的 ID 值 为 Rjava 文件 中 id 类 的 成 员 常 量 textViewl. Android SDK 提供 了 @[<package_ 
name>:]<resource_type>/<resource name> 方 式 以 便于 从 xml 文件 中 访问 工程 的 资源 。 
android:text="(@string/hello" 指 明 该 TextView 组 件 显示 的 内 容 为 资源 文件 string.xml. 中 定义 的 
hello 变量 的 内 容 。android:text 属性 也 可 以 直接 指定 要 显示 的 字符 串 ， 但 是 在 实际 的 工程 开发 
过 程 中 不 鼓励 这 种 方式 ， 而 应 该 使 用 资源 文件 中 的 变量 ， 因 为 这 样 便于 工程 维护 和 国际 化 。 
在 本 书 中 ， 为 了 节省 篇 幅 ， 部 分 显示 内 容 简单 的 组 件 使 用 了 字符 串 直接 赋值 的 方法 。 
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Android 工程 中 使 用 到 的 资源 文件 都 会 在 gen 目录 下 的 Rjava 中 生成 对 应 项 ， 由 系统 为 每 
个 资源 分 配 一 个 十 六 进 制 的 整 型 数值 ， 唯 一 标明 每 个 资源 。 
HelloAndroid 工程 中 的 Rjava 文 件 代 码 如 下 : 


package introduction.android.helloAndroid; 


public final class R { 
public static final class attr { 
} 
public static final class drawable { 
public static final int ic launcher-0x7f020000; 


I 
public static final class id { 
public static final int textView1-0x7f050000; 
} 


public static final class layout { 
public static final int main-0x7f030000; 

} 

public static final class string { 
public static final int app name-0x7f040001; 
public static final int hello=0x7f£040000; 


) 


由 该 文件 可 见 ，R 为 静态 最 终 类 。 其 中 public static final class layout 代表 的 是 res/layout 
文件 夹 的 内 容 ，layout 类 的 每 个 整 型 常量 代表 该 文件 夹 下 的 一 个 xml 布局 文件 。 例 如 ，public 
static final int main 代表 的 是 main.xml 文件 ，0x7f030000 为 系统 main.xml 文件 生成 的 整 型 数 
值 。 在 Android 工程 中 根据 该 数值 找到 main.xml Xf. public static final class string 代表 的 是 
res/values/strings.xml 文件 ，string 类 中 的 每 个 整 型 常量 型 成 员 代表 strings.xml 文件 中 定义 的 一 
个 变量 。 例 如 ，public static final int app_name 代表 strings.xml 中 定义 的 app_name 变量 ， 
public static final int hello 代表 stings.xml 文件 中 定义 的 hello 变量 。 

在 工程 开发 过 程 中 ， 可 以 通过 [<package_name>.]R.<resource_type>.<resource_name> 方 式 
来 访问 R 中 定义 的 任意 资源 。 其 中 package name 为 资源 文件 被 放置 的 包 路 径 ， 一 般 可 以 省 
Wt. resource type 为 资源 类 型 ， 例 如 layout, string, color, drawable, menu 等 。resource_ 
name 指 的 是 为 资源 文件 在 类 中 定义 的 整 型 常量 的 名 字 。 例 如 : 


setContentView (R.layout.main) ; 
这 行 代码 中 ， 通 过 Rlayoutmain 找到 了 布局 文件 main.xml， 并 通过 setContentView 方法 
将 其 设置 为 当前 Activity 的 视图 。 要 从 视图 中 查找 某 个 组 件 ， 需 要 使 用 findViewById 方 法 ， 通 过 


组 件 ID 获取 到 组 件 的 对 象 。 例 如 要 获取 到 main.xml 中 的 TextView 组 件 对 象 ， 需 要 执行 以 下 
代码 : 
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TextView textview= (TextView) findViewById (R.id.textViewl) ; 


布局 


Android SDK 定义 了 多 种 布局 方式 以 方便 用 户 UI 设计 。 各 种 布局 方式 均 为 ViewGroup 类 
的 子 类 ， 结 构 如 图 4.3 所 示 。 本 节 将 对 FrameLayout ( 单 帧 布局 ) 、LinearLayout〔 线 性 布 
局 ) . AbsoluteLayout (绝对 布局 ) ~ RelativeLayout (相对 布局 ) 和 TableLayout (表格 布 
局 ) 进行 简单 的 介绍 。 


ViewGroup 


| | 


AbsoluteLayout LinearLayout RelativeLayout || FrameLayout AdapterView 
<T extends 
| Adapter> 


TabWidget TableLayout | TableHost 


图 4.3 Android SDK 布局 方式 结构 图 


4.3.1 FrameLayout 

FrameLayout 又 称 单 帧 布局 ， 是 Android 所 提供 的 布局 
方式 里 最 简单 的 布局 方式 ， 它 指定 屏幕 上 的 一 块 空白 区 
域 ， 在 该 区 域 填充 一 个 单一 对 象 ， 例 如 图 片 、 文 字 、 按 钮 LONE 
等 。 应 用 程序 开发 人 员 不 能 为 FrameLayout PIMA Ee 
指定 具体 填充 位 置 ， 默 认 情 况 下 ， 这 些 组 件 都 将 被 固定 在 
屏幕 的 左上 角 ， 后 放 入 的 组 件 会 放 在 前 一 个 组 件 上 进行 覆 
盖 填 充 ， 形 成 部 分 遮挡 或 全 部 遮挡 。 开 发 人 员 可 以 通过 组 
件 的 android:layout_gravity 属性 对 组 件 位 置 进行 适当 的 修 
改 。 

实例 FrameLayoutDemo 演示 了 FrameLayout 的 布局 效 
果 。 该 布局 中 共有 四 个 TextView 组 件 ， 前 三 个 组 件 以 默认 
方式 放置 到 布局 中 ， 第 四 个 组 件 修改 gravity 属性 后 放置 到 
布局 中 ， 运 行 效果 如 图 4.4 所 示 。 

实例 FrameLayoutDemo 中 的 布局 文件 main.xml 的 代码 
如 下 : 


图 4.4 FrameLayout 的 布局 效果 
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«FrameLayout xmlns:android-"http://schemas.android.com/apk/res/android" 


android:layout width-"fill parent" 


android:layout height-"fill parent"» 


«TextView 


android: id="@+id/text1" 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:textColor-"400ff00" 
android:textSize-"100dip" 
android:text-"Gstring/first"/» 


«TextView 


android: id="@+id/text2" 

android: layout_width="wrap_ content" 
android:layout height-"wrap content" 
android:textColor-"400ffff" 
android:textSize-"70dip" 

android: text="@string/second"/> 


<TextView 


android: id="@+id/text3" 

android: layout_width="wrap_ content" 
android:layout height-"wrap content" 
android:textColor-"4ff0000" 
android:textSize-"40dip" 
android:text-"Gstring/third"/» 


«TextView 


android:id-"G*id/text4" 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:textColor-"4Zffff00" 
android:textSize-"40dip" 
android:layout gravity- "bottom" 
android:text-"Gstring/forth"/» 


</FrameLayout> 


其 中 ， 


android:layout width-"wrap content" 


android:layout height-"wrap content" 


表明 FrameLayout 布局 覆盖 了 整个 屏幕 空间 。 


实例 FrameLayoutDemo 中 的 string.xml 文件 内 容 如 下 : 


<?xml version="1.0" encoding="utf-8"?> 
<resources> 
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<string name="app_name">FrameLayoutDemo</string> 
«string name="first"> 第 一 层 </string> 
«string name="second"> 第 二 层 </string> 
<string name="third"> 第 三 层 </string> 
<string name="forth"> 第 四 层 </string> 
</resources> 


从 运行 后 的 结果 可 见 ， 前 三 个 被 放置 到 FrameLayout 的 TextView 组 件 都 是 以 屏幕 左上 角 
为 基点 进行 全 加 的 。 第 四 个 TextView 因为 设置 了 android:layout gravity="bottom" 属 性 而 显示 
到 了 布局 的 下 方 。 读 者 可 自行 将 android:layout_gravity 属性 值 修改 为 其 他 属性 ， 查 看 运行 效 
果 。 


4.3.2 LinearLayout 

LinearLayout 又 称 线性 布局 ， 该 布局 应 该 是 Android 视图 设计 中 最 经 常 使 用 的 布局 。 该 布 
局 可 以 使 放 入 其 中 的 组 件 以 水 平方 式 或 者 重 直 的 方式 整齐 排列 ， 通 过 android:orientation 属性 
指定 具体 的 排列 方式 ， 通 过 weight 属性 设置 了 每 个 组 件 在 布局 中 所 占 的 比重 。 

实例 LinearLayoutDemo 演示 了 LinearLayout 布局 的 使 用 方法 ， 效 果 如 图 4.5 所 示 。 


[s] LinearLayoutDemo 


red blue 


row one 
row two 
row three 
row four 


图 4.5 LinearLayout 的 布局 效果 
实例 LinearLayoutDemo 中 的 strings.xml 文件 代码 如 下 : 


<?xml version-"1.0" encoding-"utf-8"?» 
«resources» 
«string name="app_name">LinearLayoutDemo</string> 
«string name-"red"»red«/string» 
«string name="yellow">yellow</string> 
«string name="green">green</string> 
«string name="blue">blue</string> 
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«string name="rowl">row one</string> 

<string name="row2">row two</string> 

<string name="row3">row three</string> 

<string name="row4">row four</string> 
</resources> 


实例 LinearLayoutDemo 中 的 布局 文件 main.xml 代码 如 下 : 


<?xml version="1.0" encoding-"utf-8"?» 
<LinearLayout 
xmlns:android-"http://schemas.android.com/apk/res/android" 
android:orientation-"vertical" 
android:layout width-"fill parent" 
android: layout_height="fill_parent"> 


<LinearLayout 
android: orientation="horizontal" 
android:layout width-"fill parent" 
android:layout height-"fill parent" 
android:layout weight-"1"» 
«TextView 
android:text-"Gstring/red" 
android:gravity-"center horizontal" 
android: background="#aa0000" 
android:layout width-"wrap content" 
android:layout height-"fill parent" 
android:layout weight-"1"/» 
«TextView 
android:text-"Gstring/green" 
android:gravity-"center horizontal" 
android: background="#00aa00" 
android: layout_width="wrap_content" 
android:layout height-"fill parent" 
android:layout weight-"1"/» 
«TextView 
android:text-"Gstring/blue" 
android:gravity-"center horizontal" 
android: background="#0000aa" 
android: layout_width="wrap_content" 
android:layout height-"fill parent" 
android:layout weight-"1"/» 
«TextView 
android:text="@string/yellow" 
android:gravity-"center horizontal" 
android:background-"£aaaa00" 
android:layout width-"wrap content" 
android:layout height-"fill parent" 
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android: layout_weight="1"/> 
</LinearLayout> 


<LinearLayout 
android:orientation="vertical" 
android: layout_width="fill_parent" 
android: layout_height="fill_parent" 
android: layout_weight="1"> 
<TextView 
android: text="@string/rowl" 
android: textSize="15pt" 
android: layout_width="fill_parent" 
android: layout_height="wrap_content" 
android: layout_weight="1"/> 
<TextView 
android: text="@string/row2" 
android: textSize="15pt" 
android:layout width-"fill parent" 
android:layout height-"wrap content" 
android:layout weight-"1"/» 
«TextView 
android:text-"Gstring/row3" 
android:textSize-"15pt" 
android:layout width-"fill parent" 
android:layout height-"wrap content" 
android:layout weight-"1"/» 
«TextView 
android:text-"Gstring/row4" 
android:textSize-"15pt" 
android:layout width-"fill parent" 
android:layout height-"wrap content" 
android:layout weight-"1"/» 
«/LinearLayout» 


</LinearLayout> 


该 布局 中 放置 了 两 个 LinearLayout 布局 对 象 。 第 一 个 LinearLayout 布局 通过 android: 
orientation-"horizontal" 属性 将 布局 设置 为 横向 线性 排列 ， 第 二 个 LinearLayout 布局 通过 
android:orientation="vertical" 属 性 将 布局 设置 为 纵向 线性 排列 。 每 个 LinearLayout 布局 中 都 放 
入 了 四 个 TextView， 并 通过 android:layout_weight 属性 设置 每 个 组 件 在 布局 中 所 占 比重 相 
同 ， 即 各 组 件 大 小 相同 。layout_weight 用 于 定义 一 个 线性 布局 中 某 组 件 的 重要 程度 。 所 有 的 
组 件 都 有 一 个 layout weight 值 ， 默 认为 0， 意 思 是 需要 显示 多 大 的 视图 就 占据 多 大 的 屏幕 空 
间 。 芳 赋值 为 大 于 0 的 值 ， 则 将 可 用 的 空间 分 割 ， 分 割 的 大 小 取决 于 当前 的 layout weight Zi 
值 同 其 他 空间 的 layout weight 值 的 比率 而 定 ， 例 如 水 平方 向 上 有 两 个 按钮 ， 每 个 按钮 的 
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layout weight 数值 都 设置 为 1， 那 么 这 两 个 按钮 平分 宽度 ; 若 第 一 个 为 1 第 二 个 为 2， 则 可 用 
空间 的 三 分 之 一 分 给 第 一 个 ， 三 分 之 二 分 给 第 二 个 。 

将 LinearLayoutDemo 中 水 平 LinearLayout 的 第 四 个 TextView 的 android:layout weight 属 
性 赋值 为 2， 运行 效果 如 图 4.6 所 示 。 


E LinearLayoutDemo 


red blue 


row one 
row two 
row three 
row four 


图 4.6 ”修改 android:layout_weight 属性 
LinearLayout 布局 可 使 用 嵌 套 。 活 用 LinearLayout 布局 ， 可 以 设计 出 各 种 各 样 漂亮 的 布 
局 方式 。 


4.3.3 RelativeLayout 
RelativeLayout 又 称 相对 布局 。 从 名 称 上 可 以 看 出 ， 这 种 布局 方式 是 以 一 种 让 组 件 以 相对 
于 容器 或 者 相对 于 容器 中 的 另外 一 个 组 件 的 相对 位 置 进行 放置 的 布局 方式 。 
RelativeLayout 布局 提供 了 一 些 常 用 的 布局 设置 属性 用 于 确定 组 件 在 视图 中 的 相对 位 置 。 
相关 属性 及 其 所 代表 的 含义 列举 在 表 4.1 中 。 
表 4.1 RelativeLayout 布局 常用 属性 


属性 描述 
android:layout_above 将 该 组 件 的 底部 置 于 给 定 ID 的 组 件 之 上 
android:layout_below 将 该 组 件 的 底部 置 于 给 定 ID 的 组 件 之 下 


Ht Pe a ID A De 
Ht Ee ate ID A A 


android:layout_alignBottom 将 该 组 件 的 底 边 与 给 定 ID 的 组 件 底 边 对 齐 
android:layout_alignBaseline 将 该 组 件 的 baseline 4524 ID 的 baseline 对齐 
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android:layout alignTop 


将 该 组 件 的 顶部 边缘 与 给 定 ID 的 顶部 边缘 对 齐 


android:layout_alignBottom 


将 该 组 件 的 底部 边缘 与 给 定 ID 的 底部 边缘 对 齐 


android:layout_alignLeft 


将 该 组 件 的 左边 缘 与 给 定 ID 的 左边 缘 对 齐 


( 续 表 ) 


属性 


描述 


android:layout_alignRight 


将 该 组 件 的 右边 缘 与 给 定 ID 的 右边 缘 对 齐 


android:layout_alignParentTop 


为 tue, 将 该 组 件 的 顶部 与 其 父 组 件 的 顶部 对 齐 


为 me, 将 该 组 件 的 底部 与 其 父 组 件 的 底部 对 齐 
为 me, 将 该 组 件 的 左 部 与 其 父 组 件 的 左 部 对 齐 


android:layout_alignParentRight 


为 mue, 将 该 组 件 的 右 部 与 其 父 组 件 的 右 部 对 齐 


android:layout_centerHorizontal 


为 mue, 将 该 组 件 的 置 于 水 平 居中 


android:layout_centerVertical 


为 tue, 将 该 组 件 的 置 于 垂直 居中 


为 me 将 该 组 件 的 和 于 父 组 人 的 中 央 


实例 RelativeLayoutDemo 演示 了 相对 布局 的 使 用 方法 ， 其 运行 效果 如 图 4.7 所 示 。 


F RelativeLayoutDemo 


RelativeLayout 相对 


确定 


图 4.7 RelativeLayout 布局 效果 


实例 RelativeLayoutDemo 中 的 布局 文件 main.xml 代码 如 下 : 


<?xml version="1.0" encoding="utf-8"?> 


<RelativeLayout 


xmlns:android- "http://schemas.android.com/apk/res/android" 
android:layout width-"fill parent" 
android:layout height-"fill parent" 
android-"http://schemas.android.com/apk/res/android"» 


«TextView 


android: id="@+id/label" 
android: layout_width="fill parent" 
android: layout_height="wrap_ content" 
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android:text="@string/hello" /> 


<EditText 
android: id="@+id/enter" 
android: layout_width="fill parent" 
android: layout_height="wrap_ content" 
android:layout alignParentLeft- "true" 
android: layout_below="@+id/label" /> 


<Button 
android: id="@+id/button1" 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:layout alignParentRight-"true" 
android: layout_below="@+id/enter" 
android: text="@string/butltext" /> 


<Button 
android: id="@+id/ok" 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android: layout_alignBottom="@+id/button1" 
android: layout_alignParentLeft="true" 
android: text="@string/but2text" /> 


</RelativeLayout> 
该 RelativeLayout 布局 的 过 程 如 下 : 


人 EXOD) 放置 了 一 个 id 为 label 的 TextView 组 件 。 

人 2 通过 android:layout below="@+id'label" 属 性 将 id # enter 的 组 件 EditText 放置 到 了 
TextView 的 下 面 。 

En 在 布局 中 加 入 了 一 个 id 为 buttonl 的 Button， 通 过 android:layout_below="@+ 
id/enter" 属 性 将 该 Button 放置 到 enter 的 下 面 ， 通 过 android:layout_alignParentRight= 
"true" 属 性 将 Button 放置 到 相对 布局 的 右面 。 

ED 在 相对 布局 中 加 入 一 个 名 为 ok 的 Button， 通 过 android:layout_alignBottom="@+ 
id/button1" 属 性 将 该 Button 底 边 与 buttonl 对 齐 ， 通 过 android:layout alignParentLeft 
="true" 属 性 将 该 Button 放置 到 布局 的 左边 。 


4.3.4 TableLayout 

TableLayout 又 称 为 表格 布局 ， 以 行列 的 方式 管理 组 件 。TableLayout 布局 没有 边框 ， 可 
以 由 多 个 TableRow 对 象 或 者 其 他 组 件 组 成 ， 每 个 TableRow 可 以 由 多 个 单元 格 组 成 ， 每 个 单 
元 格 是 一 个 View。TableRow 不 需要 设置 宽度 layout_width 和 高 度 layout_height ， 其 宽度 一 定 
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是 match_parent， 即 自动 填 满 父 容器 ， 高 度 一 定 为 wrap_content， 即 根据 内 容 改 变 高 度 。 但 对 
于 TableRow 中 的 其 他 组 件 来 说 ， 是 可 以 设置 宽度 和 高 度 的 ， 只 是 必须 是 wrap_content 或 者 
fill parent, 
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实例 TableLayoutDemo 演示 了 使 用 TableLayout 制作 UI 的 方法 ， 效 果 如 图 4.8 所 示 。 


图 4.8 TableLayout 布局 效果 


实例 TableLayoutDemo 中 strings.xml 代码 如 下 : 


<?xml version-"1.0" encoding-"utf-8"?» 
«resources» 
«string name="hello">Hello World, TableLayout!</string> 
«string name-"app name"»TableLayoutDemo«/string» 
«string name="column1"> 第 一 行 第 一 列 </string> 
«string name="column2"> 第 一 行 第 二 列 </string> 
«string name="column3"> 第 一 行 第 三 列 </string> 
«string name="empty"> 最 左面 的 可 伸缩 TextView</string> 
«string name="row2column2"> 第 二 行 第 三 列 </string> 
<string name="row2column3">End</string> 
<string name="merger"> 合 并 三 个 单元 格 </string> 
</resources> 


实例 TableLayoutDemo 中 的 布局 文件 main.xml 的 代码 如 下 : 


<?xml version="1.0" encoding="utf-8"?> 
«TableLayout xmlns:android="http://schemas. android.com/apk/res/android" 
android: layout_width="fill parent" 
android: layout_height="fill parent" > 
<TableRow> 
<TextView 
android: text="@string/column1" /> 
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<TextView 
android:text="@string/column2" /> 
<TextView 
android:text-"Gstring/column3" /> 
</TableRow> 


<TextView 
android: layout_height="wrap_ content" 
android: background="#fff000" 
android: text="#ijipy—-f TextView" 
android: gravity="center"/> 
<TableRow> 
<Button 
android: text="@string/merger" 
android: layout_span="3" 
android:gravity="center_horizontal" 
android: textColor="#f00" 
/> 
</TableRow> 


<TextView 
android: layout_height="wrap_content" 
android: background="#fa05" 
android:text-"/7///j—^* TextView"/» 
«TableRow android:layout height-"wrap content"» 
«TextView 
android:text-"Gstring/empty" /> 
«Button 
android:text-"Gstring/row2column2" /> 
«Button 
android:text-"Gstring/row2column3" /» 
</TableRow> 
</TableLayout> 


布局 文件 main.xml 在 TableLayout 布局 内 添加 了 两 个 TableRow 和 两 个 TextView， 形 成 了 
如 图 4.8 所 示 的 效果 。 从 运行 效果 看 ， 第 一 行 和 第 五 行 都 没 能 完全 显示 。TableLayout 布局 提 
供 几 个 特殊 属性 ， 可 以 实现 以 下 特殊 效果 。 比 如 : 


* android:shrinkColumns 属性 : 该 属性 用 于 设置 可 收缩 的 列 。 当 可 收缩 的 列 太 宽 以 至 于 
布局 内 的 其 他 列 不 能 完全 显示 时 ， 可 收缩 列 会 纵向 延伸 ， 压 缩 自己 所 占 空间 ， 以 便于 
其 他 列 可 以 完全 显示 出 来 。android:shrinkColumns=“1” 表 示 将 第 2 列 设置 为 可 收缩 
列 ， 列 数 从 0 开始 。 

* android:stretchColumns 属性 : 该 属性 用 于 设置 可 伸展 的 列 。 可 伸展 列 会 自动 扩展 长 度 
以 填 满 所 有 可 用 空间 。android:stretchColumns=“1? 表 示 将 第 2 列 设置 为 可 伸展 列 。 
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* android:collapseColumns 属性 : 该 属性 用 于 设置 隐藏 列 。android:collapseColumns=“1” 
表示 将 第 2 列 隐藏 不 显示 。 
在 <TableLayout> 标 签 添加 属性 android:shrinkColumns="0"， 再 次 运行 ， 效 果 如 图 4.9 所 
示 ， 可 以 看 出 第 一 行 和 第 五 行 都 完全 显示 出 来 。 


[a TableLayoutDemo 


单独 的 一 个 TextView 


促 ”第 二 行 第 三 列 End 


图 4.9 显示 完全 的 效果 


4.3.5 AbsoluteLayout 

AbsoluteLayout 又 称 绝对 布局 ， 放 入 该 布局 的 组 件 需要 通过 android:layout x 和 
android:layout_y 两 个 属性 指定 其 准确 的 坐标 值 ， 并 显示 在 屏幕 上 。 理 论 上 AbsoluteLayonut 布 
局 可 用 以 完成 任何 的 布局 设计 ， 灵 活性 很 大 ， 但 是 在 实际 的 工程 应 用 中 不 提倡 使 用 这 种 布 
局 。 因 为 使 用 这 种 布局 不 但 需要 精确 计算 每 个 组 件 的 大 小 ， 增 大 运算 量 ， 而 且 当 应 用 程序 在 
不 同 屏幕 尺寸 的 手机 上 运行 时 会 产生 不 同 效果 。 

实例 AbsoluteLayoutDemo 演示 了 AbsoluteLayout 布局 的 使 用 方法 ， 效 果 如 图 4.10 所 示 。 
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E AbsoluteLayoutDemo 


AbsoluteLayou 


位 置 响 ~~ 亲 


uteLayout 


图 4.10 AbsoluteLayout 布局 效果 
实例 AbsoluteLayoutDemo 的 布局 文件 main.xml 代码 如 下 : 


<?xml version-"1.0" encoding-"utf-8"?» 
«AbsoluteLayout 
xmlns:android-"http://schemas.android.com/apk/res/android" 
android:layout width-"fill parent" 
android:layout height-"fill parent"» 


«TextView 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:layout x-"10px" 
android:layout y-"10px" 
android: text="@string/hello"> 
</TextView> 


<TextView 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:layout x-"80px" 
android:layout y-"80px" 
android: text="@string/action"> 
</TextView> 


<TextView 
android: layout_width="wrap_ content" 
android: layout_height="wrap_ content" 
android: layout_x="150px" 
android: layout_y="150px" 
android: text="@string/hello"> 
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</TextView> 


</AbsoluteLayout> 


其 中 ， 


android: layout_x="80px" 
android: layout_y="80px" 


表示 将 组 件 放置 到 以 屏幕 左上 角 为 坐标 原点 的 坐标 系 下 ，x 值 为 80 像素 ，y (79 80 像素 
的 位 置 。 
在 这 里 简单 介绍 一 下 Android 系统 常用 的 尺寸 类 型 的 单位 : 


像素 : 缩写 为 px。 表示 屏幕 上 的 物理 像素 。 

Hk: points， 缩 写 为 pt。1lpt 等 于 1 英寸 的 1172， 常 用 于 印刷 业 。 

放大 像素 : sp。 主 要 用 于 字体 的 显示 ，Android 默认 使 用 sp 作为 字号 单位 

密度 独立 像素 : 缩写 为 dip 或 dp。 该 尺寸 使 用 160dp 的 屏幕 作为 参考 ， 然 后 用 该 屏幕 
映射 到 实际 屏幕 ， 在 不 同 分 辨 率 的 屏幕 上 会 有 相应 的 缩放 效果 以 适用 不 同 的 分 辨 率 的 
屏幕 。 若 用 px 的 话 ，320px bi HVGA 的 宽度 ， 到 WVGA 上 就 只 能 占 一 半 不 到 的 屏 
幕 了 ， 那 一 定 不 是 你 想 要 的 。 

e ZA: mm, 


4.3.6 WebView 

WebView 组 件 是 AbsoluteLayout 的 子 类 ， 用 于 显示 Web 页 面 。 借 助 于 WebView， 可 以 方 
便 地 开发 自己 的 网 络 浏览 器 。 

创建 Eclipse 工程 WebViewDemo， 为 其 在 AndroidManifest.xml 文件 中 添加 Internet 访问 
权限 : 


«uses-permission android:name-"android.permission.INTERNET" /> 


在 布局 文件 main.xml 中 添加 一 个 WebView 组 件 。Main .xml 内 容 如 下 : 


<?xml version-"1.0" encoding-"utf-8"?» 
«LinearLayout 
xmlns:android-"http://schemas.android.com/apk/res/android" 
android:layout width-"fill parent" 
android:layout height-"fill parent" 
android:orientation-"vertical"» 


«WebView 
android: id="@+id/webView1" 
android:layout width-"match parent" 
android:layout height-"match parent" /» 
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</LinearLayout> 


实例 WebViewDemo 中 的 Activity 文件 WebViewDemoActivity.java 代码 如 下 : 
package introduction.android.webView; 


import android.app.Activity; 
import android.os.Bundle; 
import android.webkit.WebView; 


public class WebViewDemoActivity extends Activity { 
private WebView webView; 


/** Called when the activity is first created. */ 

@Override 

public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState) ; 
setContentView (R.layout.main) ; 
webView- (WebView) findViewById (R.id.webViewl) ; 
webView.getSettings().setJavaScriptEnabled (true) ; 
webView.loadUrl ("http://www.google.com") ; 


运行 效果 如 图 4.11 所 示 。 


Google.com.hk 使 用 下 列 语言 PX CRE 


图 4.11 WebViewDemo 运行 界面 
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在 前 面 章节 的 学 习 中 讲解 了 用 户 界面 UI 设计 中 布局 方面 的 知识 ， 其 中 涉及 了 少数 几 个 
常用 的 组 件 ， 例 如 按钮 、 文 本 框 等 。 在 这 一 节 中 着 重 讲解 Android 用 户 UI 设计 中 常用 的 各 种 
组 件 的 用 法 。 

Android SDK 提供 了 名 android.widget 的 包 ， 其 中 提供 了 在 应 用 程序 界面 设计 中 大 部 分 常 
用 的 UL 可 视 组 件 。 之 前 章节 中 涉及 的 各 种 布局 以 及 文本 框 、 按 钮 等 组 件 ， 都 包含 在 这 个 包 
中 。Android 提供 了 强大 的 用 户 UI 功能 ， 要 设计 自己 独特 的 应 用 程序 界面 ， 需 要 对 各 个 组 件 
有 一 个 详细 的 了 解 。 


4.4.1 ”创建 Widget 组 件 实例 


在 Eclipse 中 创建 一 个 新 的 工程 ， 名 字 为 WidgetDemo， 用 于 对 各 种 常见 UI 组 件 进行 学 

习 。 下 面 是 工程 实现 步 又， 在 后 续 的 章节 中 不 会 再 歼 述 该 过 程 : 

人 OO)， 新 建 项 目 。 单 击 File | New | Android Project， 打 开 New Android Projec 对 话 框 ， 如 
图 4.12 所 示 。 

€o 输入 工程 名 称 WidgetDemo， 在 Location 后 的 文本 框 中 输入 工程 的 保存 路 径 ， 单 击 
Next 后 选择 Android4.0， 单 击 Next. 

© 输入 包 名 “introduction.android.widgetDemo" 和 Activity 的 名 称 WidgetDemoActivity， 
单 击 Finish， 则 Eclipse 会 生成 工程 目录 和 相关 文件 。 

B New Android Project Im 


Create Android Project. 
Select project name and type of project 


Add project to working ete 


412 ”新建 项 目 
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WidgetDemoActivityjava 文件 是 当前 应 用 程序 的 入 口 类 WidgetDemoActivity 的 定义 文 
件 。 双 击 WidgetDemoActivityjava， 发 现 Eclipse 已 经 为 其 生成 代码 如 下 : 


package introduction.android.widgetDemo; 
import android.app.Activity; 
import android.os.Bundle; 
public class WidgetDemoActivity extends Activity { 
/** Called when the activity is first created. */ 
@Override 
public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState) ; 
setContentView (R.layout.main) ; 


} 


其 中 onCreate0 方 法 中 的 setContentView (R.layout.main) 表明 WidgetDemoActivity 使 用 
的 用 户 界面 UI 文件 为 main.xml。 
双击 main.xml 文件 ， 发 现 Eclipse 为 其 提供 了 “Graphical Layout” 和 “main.xml” 两 种 
浏览 方式 。 其 中 “Graphical Layout” 方 式 为 以 图 形 方 式 浏览 main.xml 文件 ， 其 效果 等 同 于 
main.xml 在 手机 设备 上 运行 的 效果 ; “main xml” 方 式 为 以 代码 方式 浏览 main.xml 文件 。 这 
两 种 方式 是 等 效 的 ， 都 可 以 对 main.xml 文件 进行 编辑 和 查看 。 单 击 “main.xml” 标 签 ， 发 现 
Eclipse 已 经 为 其 生成 代码 如 下 : 
<?xml version-"1.0" encoding-"utf-8"?» 
«LinearLayout 
xmlns:android-"http://schemas.android.com/apk/res/android" 
android:layout width-"fill parent" 
android:layout height-"fill parent" 
android:orientation-"vertical"» 
«TextView 
android:layout width-"fill parent" 
android:layout height-"wrap content" 


android: text="@string/hello" /> 
</LinearLayout> 


该 文件 表明 ， 当 前 main.xml 文件 所 使 用 的 布局 为 LinearLayout 布局 ， 该 布局 自动 填 满 整 
个 手机 屏幕 。 在 该 布局 中 ， 放 置 了 一 个 TextView 组 件 ， 该 TextView 显示 的 内 容 为 
"@string/hello", #7 string.xml 文件 中 定义 的 hello 变量 的 内 容 。 双 击 values 目录 下 的 
string.xml 文件 ， 会 发 现 hello 变量 对 应 的 值 为 “Hello World, WidgetDemoActivity!”。 

单 击 main.xml 的 “Graphical Layout” 浏 览 方式 ， 可 查看 当前 文件 的 图 形 化 效果 ， 如 图 
4.13 所 示 。 
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Form Widgets 


Text Fields 
Layouts 
Composite 
Images & Media 
Time & Date 
Transitions 
Advanced 
Other 


Custom & Library Views 


图 4.13 文件 的 图 形 化 效果 


呈 序 开发 人 员 可 以 在 该 图 形 方式 下 ， 将 左 侧 的 各 种 组 件 直接 拖 电 到 屏幕 上 形成 自己 想 要 
的 布局 ， 也 可 以 直接 修改 main.xml 文件 的 代码 。 
在 后 续 章 节 中 ， 在 对 布局 文件 进行 修改 时 ， 若 非特 殊 情 况 将 不 再 单独 描述 。 


4.4.2 #4 (Button) 


Button 按钮 应 该 是 用 户 交 互 中 使 用 最 多 的 组 件 ， 在 很 多 应 用 程序 中 都 很 常见 。 当 用 户 单 
击 按钮 的 时 候 ， 会 有 相对 应 的 响应 动作 。 下 面 在 WidgetDemo 工程 的 主 界面 中 main.xml 中 放 
置 一 个 名 为 Button 的 按钮 。 文 件 代 码 如 下 : 


<?xml version="1.0" encoding="utf-8"?> 


<LinearLayout 


xmlns:android-"http://schemas.android.com/apk/res/android" 
android:layout width-"fill parent" 
android:layout height-"fill parent" 
android:orientation-"vertical"» 


«TextView 


android: 


android 


«Button 


android: 


android 


</LinearLayout> 
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layout_width="fill parent" 


:layout height-"wrap content" 


android:text-"estring/hello" /> 


id="@+id/button1" 


:layout width-"wrap content" 
android: 
android: 


layout height-"wrap content" 
text-"Button" /» 


其 中 ， 

<Button 
android: id="@+id/button1" 
android:layout width-"wrap content" 


android:layout height-"wrap content" 
android:text-"Button" /» 


表明 在 用 户 界面 上 放置 了 一 个 id 为 “button1” 的 按钮 ， 按 钮 的 高 度 Clayout height) 和 
宽度 Clayout_width) 都 会 根据 实际 内 容 调整 (wrap_content) ， 按 钮 上 显示 文字 为 Button， 
其 运行 效果 如 图 4.14 所 示 。 


allo World, WidgetDernoActivity! 


图 4.14 Button 的 应 用 界面 


按钮 最 重要 的 用 户 交互 事件 是 “ 单 击 ” 事 件 。 下 面 为 Buttonl 添加 事件 监听 器 和 相应 的 
i 事件 。 该 过 程 在 WidgetDemoActivityjava 文件 中 完成 ， 代 码 如 下 : 


package introduction.android.widgetDemo; 


import android.app.Activity; 

import android.os.Bundle; 

import android.util.Log; 

import android.view.View; 

import android.view.View.OnClickListener; 
import android.widget.Button; 


public class WidgetDemoActivity extends Activity { 
/** Called when the activity is first created. */ 
@override 
public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState) ; 
setContentView (R.layout.main) ; 
Button btn- (Button) this.findViewById (R.id.buttonl) ; 
btn.setOnClickListener (new OnClickListener () { 
@Override 
public void onClick (View v) { 
// TODO Auto-generated method stub 
setTitle ("buttonl 被 用 户 点 击 了 ") ; 
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Log.i ("widgetDemo", "buttonl 被 用 户 点 击 了 。 ") 7 


H 


在 WidgetDemoActivity 的 onCreate() 方 法 中 ， 通 过 findViewByld (R.id.buttonl) 方法 获 
得 的 Buttonl 的 对 象 ， 通 过 setOnClickListener() 方 法 为 Buttonl 设置 了 监听 器 。 此 处 新 建 了 一 
个 实现 了 OnClickListener 接口 的 匿名 类 作为 监听 器 ， 并 实现 了 onClick0 方 法 。 当 Buttonl 被 
点 击 ， 当 前 应 用 程序 的 标题 被 设置 成 “buttonl 被 用 户 点 击 了 ”， 对 应 在 LogCat 中 也 会 打印 
相应 的 字符 串 ， 运 行 结 果 如 图 4.15 所 示 。 


r button] 被 用 户 点 击 了 


Hello World, WidgetDemoActivity! 


Button 


widgetDemo buttonl RAP SBT. 


图 4.15 点 击 按钮 运行 效果 


4.4.3 “文本 框 (TextView) 


TextView 是 用 于 在 界面 上 显示 文字 的 组 件 ， 其 显示 的 文本 不 可 被 用 户 直 接 编辑 。 程 序 开 
发 人 员 可 以 设置 TextView 字 体 大 小 、 颜 色 、 样 式 等 属性 。 在 工程 WidgetDemo 的 main.xml 中 
添加 一 个 TextView， 代 码 如 下 : 


<TextView 
android:id="@+id/textView1" 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:text-"TextView" /> 


运行 效果 如 图 4.16 所 示 。 
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lal WidgetDemo 


Hello World, WidgetDemoActivity! 


Button 


TextView 


图 4.16 TextView 的 应 用 界面 


修改 Buttonl 的 单 击 事件 为 : 


public void onClick (View view) { 
// TODO Auto-generated method stub 
//setTitle ("buttonl 被 用 户 单 击 了 ") ; 
Log.i ("widgetDemo", "buttonl 被 用 户 单 击 了 。 "); 

TextView textview= (TextView) findViewById (R.id.textView1) ; 
textview.setText ("设置 TextView 的 字体 ") ; 
textview.setTextColor (Color.RED) ; 
textview.setTextSize (TypedValue.COMPLEX UNIT SP, 20) ; 

textview.setTypeface (Typeface.defaultFromStyle 
(Typeface.BOLD) ) ; 
} 


当 Button! 被 单 击 时 ， 通 过 setText0 方 法 更 改 textView 的 显示 内 容 为 “设置 TextView 的 
字体 ”， 通 过 setTextColor() 方 法 修改 textView 显示 字体 的 颜色 为 红色 ， 通 过 setTextSize() 方 
法 修改 textView 显示 字体 的 大 小 为 20sp， 通 过 setTypeface() 方 法 修改 textView 显示 字体 的 风 
格 为 加 粗 。 


n WidgetDemo 


Hello World, WidgetDemoActivity! 


Button 


图 4.17 再 次 单 击 按钮 运行 效果 


当然 ， 该 过 程 也 可 以 通过 修改 mainxml 文件 来 实现 。 将 TextView 标签 按照 如 下 代码 修 
改 也 可 得 到 同样 效果 ， 但 是 失去 了 应 用 程序 中 与 用 户 交互 的 过 程 : 
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<TextView 
android: id="@+id/textView1" 
android: layout_width="wrap_content" 
android:layout height-"wrap content" 
android: text="¢# TextView Hj zp" 
android: textColor="#ff0000" 
android: textSize="20sp" 
android: textStyle="bold"/> 


4.4.4 ”编辑 框 〈EditText) 


EditText 是 TextView 的 子 类 ， 在 TextView 的 基础 上 增加 了 文本 编辑 功能 ， 用 于 处 理 用 户 


输入 ， 例 如 登录 框 等 ， 是 非常 常用 的 组 件 。 


在 工程 WidgetDemo 的 main.xml 文件 中 添加 一 个 EditText， 并 实现 如 下 功能 : 当 用 户 在 


EditText 中 输入 信息 的 同时 ， 用 一 个 TextView 显示 用 户 输入 的 信息 。 
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工程 WidgetDemo 中 的 布局 文件 main.xml 中 增加 的 代码 如 下 : 


<EditText 
android:id="@+id/editText1" 
android: layout_width="match_parent" 
android:layout height-"wrap content "> 


在 WidgetDemoActivity 的 onCreate0 方 法 中 添加 下 列 代 码 : 


editText- (EditText) findViewById (R.id.editText1) ; 
editText .addTextChangedListener (new TextWatcher () { 


GOverride 
public void afterTextChanged (Editable s) ( 
// TODO Auto-generated method stub 


i 


GOverride 

public void beforeTextChanged (CharSequence s, int start, int count, 
int after) { 
// TODO Auto-generated method stub 


@Override 

public void onTextChanged (CharSequence s, int start, int before, 
int count) { 
// TODO Auto-generated method stub 


第 4 章 ”用 户 界面 开发 


String text-editText.getText().toString(); 
textview.setText (text) ; 


TUE 


运行 结果 如 图 4.18 所 示 。 


P WidgetDemo 
Hello World, WidgetDemoActivity! 


Button 


abcdefd 


FA 4.18 EditText 的 应 用 界面 


4.4.5 ”多 项 选择 按钮 (CheckBox) 

多 项 选择 按钮 CheckBox 属于 输入 型 组 件 ， 该 组 件 允许 用 户 一 次 选择 多 个 选项 。 当 不 方 
便 用 户 在 手机 屏幕 上 进行 直接 输入 操作 时 ， 该 组 件 的 使 用 显得 尤为 方便 。 

下 面 通 过 实例 讲解 CheckBox 的 使 用 方法 。 该 实例 运行 效果 如 图 4.19 所 示 。 
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P WidgetDemo 
你 的 爱好 是 听 歌 曲 看 书 
L8 篮球 


v! 听 歌 曲 
v Bt 


4.19 CheckBox 的 应 用 界面 
在 工程 WidgetDemo 的 布局 文件 main.xml 文件 中 添加 一 个 Button， 代 码 如 下 : 


<Button 
android: id="@+id/button2" 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android: text="CheckBoxDemo" /> 


当 该 Button 被 用 户 单 击 时 ， 启 动 一 个 名 为 CheckBoxActivity 的 Activity, Ei% Activity 中 
演示 CheckBox 的 使 用 方法 。 启 动 CheckBoxActivity 的 相关 代码 如 下 : 


Button ckbtn- (Button) this.findViewById (R.id.button2) ; 
ckbtn.setOnClickListener (new OnClickListener() { 


GOverride 
public void onClick (View v) ( 


// TODO Auto-generated method stub 
Intent intent-new Intent 
(WidgetDemoActivity.this,CheckBoxActivity.class) ; 
startActivity (intent) ; 
} 
jos 


同时 在 AndroidManifest.xml 文件 中 声明 该 Activity: 
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<activity android:name="CheckBoxActivity"></activity> 


CheckBoxActivity 所 使 用 的 布局 文件 为 checkbox.xml, fH] LinearLayout 布局 ， 其 中 放 
置 了 一 个 TextView 和 三 个 CheckBox。Checkbox.xml 的 文件 内 容 如 下 : 


<?xml version="1.0" encoding="utf-8"?> 
<LinearLayout 
xmins:android="http://schemas. android.com/apk/res/android" 
android:layout width-"match parent" 
android:layout height-"match parent" 
android:orientation-"vertical"» 


«TextView 
android: id="@+id/text" 
android: layout_width="fill_ parent" 
android: layout_height="wrap_ content" 
android: text="@st ring/checkboxhello"/> 
<CheckBox 
android: id="@+id/CheckBox1" 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android: text="@string/football"/> 
<CheckBox 
android: id="@+id/CheckBox2" 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android: text="@string/song"/> 
<CheckBox 
android: id="@+id/CheckBox3" 
android:layout width-"wrap content" 
android:layout height- "wrap content" 
android: text="@string/book"/> 


</LinearLayout> 


这 四 个 组 件 在 对 应 的 strings.xml 文件 中 定义 的 变量 为 : 


«string name="checkboxhe1Io"> 你 的 爱好 是 :</string> 
«string name= "footbal11"> 篮 球 </string> 
«string name= "song"> 听 歌曲 </string> 

«string name="book"> 看 书 </string> 


当 用 户 对 多 项 选择 按钮 进行 选择 时 ， 为 了 确定 用 户 选择 的 是 哪 几 项 ， 需 要 对 每 个 多 项 选 
择 按 钮 进行 监听 。CompouButton.OnCheckedChangedListener 接口 可 用 于 对 CheckBox 的 状态 


进行 监听 。 当 CheckBox 的 状态 在 未 被 选中 和 被 选中 直接 变化 时 ， 该 接口 的 onCheckedChanged0 
方法 会 被 系统 调用 。CheckBox 通过 setOnCheckedChangeListener() 方 法 将 该 接口 对 象 设置 为 


71 


Android 4.X 从 入 门 到 精通 


自己 的 监听 器 。 
CheckBoxActivity.java 代码 如 下 : 


package introduction.android.widgetDemo; 


import android.app.Activity; 

import android.os.Bundle; 

import android.widget.CheckBox; 
import android.widget.CompoundButton; 
import android.widget.TextView; 


public class CheckBoxActivity extends Activity { 
private TextView textView; 
private CheckBox bookCheckBox; 
private CheckBox songCheckBox; 
private CheckBox footbaCheckBox; 
@Override 
protected void onCreate (Bundle savedInstanceState) { 
// TODO Auto-generated method stub 
super.onCreate (savedInstanceState) ; 
this.setContentView (R.layout.checkbox) ; 
textView- (TextView) findViewById (R.id.text) ; 
footbaCheckBox- (CheckBox) findViewById (R.id.CheckBox1) ; 
songCheckBox- (CheckBox) findViewById (R.id.CheckBox2) ; 
bookCheckBox- (CheckBox) findViewById (R.id.CheckBox3) ; 
footbaCheckBox.setOnCheckedChangeListener (new 
CompoundButton.OnCheckedChangeListener () { 


@Override 
public void onCheckedChanged (CompoundButton buttonView, 
boolean isChecked) ( 
// TODO Auto-generated method stub 
if (footbaCheckBox.isChecked()) ( 
textView.append 
(footbaCheckBox.getText().toString()) ; 
Jelse { 
if (textView.getText().toString().contains ("足球 ") ) 


textView.setText 
(textView.getText().toString().replace (" 足 球 "，"") ) ; 


} 


} 
UR 
songCheckBox.setOnCheckedChangeListener (new 
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CompoundButton .OnCheckedChangeListener () { 


@Override 
public void onCheckedChanged (CompoundButton buttonView, 
boolean isChecked) { 
// TODO Auto-generated method stub 
if (songCheckBox.isChecked()) { 
textView.append 
(songCheckBox.getText ().toString()) ; 
Jelse { 
if (textView.getText().toString().contains (" 唱 歌 ") ) 
{ 
textView.setText 
(textView.getText().toString().replace (" 唱 歌 "，"") ) ; 


} 


} 
n: 


bookCheckBox.setOnCheckedChangeListener (new 
CompoundButton.OnCheckedChangeListener () { 


@Override 
public void onCheckedChanged (CompoundButton buttonView, 
boolean isChecked) ( 


// TODO Auto-generated method stub 
if (bookCheckBox.isChecked()) ( 
textView.append 
(bookCheckBox.getText ().toString()) ; 


Jelse { 
if (textView.getText().toString().contains ("读书 ") ) 


t 
textView.setText 
(textView.getText().toString().replace ("ijgj", "")); 


195; 


CheckBoxActivity 为 Checkbox.xml 文件 中 的 三 个 CheckBox 分 别 添 加 了 监听 器 。 当 
CheckBox 的 状态 发 生 改 变 时 ， 通 过 Checkbox.isChecked() 方 法 可 以 获取 当前 CheckBox 按钮 的 
选中 状态 ， 进 而 进行 处 理 。 
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4.4.6 ”单项 选择 按钮 组 (RadioGroup) 


RadioGroup 为 单 选 按钮 组 ， 其 中 可 以 包含 多 个 RadioButton， 即 单 选 按钮 ， 它 们 共同 为 
用 户 提供 一 种 多 选 一 的 选择 方式 。 在 多 个 RadioButton 被 同一 个 RadioGroup 包含 的 情况 下 ， 
多 个 RadioButton 之 间 自 动 形 成 互 斥 关系 ， 仅 有 一 个 可 以 被 选择 。 单 选 按钮 的 使 用 方法 和 
CheckBox 的 使 用 方法 高 度 相 似 ， 其 事件 监听 接口 使 用 的 是 RadioGroup.OnCheckedChangel istener(), 
使 用 setOnCheckedChangeListener() 方 法 将 监听 器 设置 到 单 选 按钮 上 。 按 照 CheckBox 的 讲解 
思路 ， 启 动 一 个 名 为 RadioGroupActivity 的 Activity 来 对 RadioGroup 进行 讲解 。 

RadioGroupActivity 运行 效果 如 图 4.20 所 示 。 


P WidgetDemo 
我 最 喜欢 的 运 


Æ 4.20 RadioGroup 的 应 用 界面 
在 工程 WidgetDemo 的 布局 文件 mainxml 文件 中 添加 一 个 Button, Jf ja wy 
RadioGroupActivity 的 相关 代码 。 在 main.xml 中 添加 代码 如 下 : 
<Button 
android: id="@+id/button3" 
android:layout width-"wrap content" 


android:layout height-"wrap content" 
android: text="RadioGroupDemo" /> 


启动 处 理 RadioGroup 的 Activity RadioGroupActivity 的 代码 如 下 : 


Button radiotn= (Button) this.findViewById (R.id.button3) ; 
radiotn.setOnClickListener (new OnClickListener()( 
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@Override 
public void onClick (View v) { 
// TODO Auto-generated method stub 
Intent intent=new Intent 
(WidgetDemoActivity.this,RadioGroupActivity.class) ; 
startActivity (intent) ; 
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同时 在 AndroidManifest.xml 文件 中 声明 该 Activity: 


<activity android:name=" RadioGroupActivity "></activity> 


RadioGroupActivity 使 用 的 是 radiogroup.xml， 其 代码 如 下 : 


<?xml version="1.0" encoding="utf-8"?> 
<LinearLayout 
xmlns:android-"http://schemas.android.com/apk/res/android" 
android:layout width- "match parent" 
android:layout height-"match parent" 
android:orientation-"vertical"» 


«TextView 
android: id="@+id/radiohello" 
android: layout_width="fill_ parent" 
android:layout height-"wrap content" 
android: text="@string/hello"/> 


<RadioGroup 
android: id="@+id/radiogroup1" 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:orientation- "vertical" 
android:layout x-"3px" 


«RadioButton 
android: id="@+id/radiobutton1" 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android: text="@string/football" 

/> 

<RadioButton 
android: id="@+id/radiobutton2" 
android: layout_width="wrap_ content" 
android:layout height-"wrap content" 
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android: text="@string/bascketball" 


/> 
<RadioButton 

android: id="@+id/radiobutton3" 
android: layout_width="wrap_ content" 
android:layout height-"wrap content" 
android: text="@string/badminton" 

/> 

</RadioGroup> 
</LinearLayout> 


该 布局 文件 使 用 了 LinearLayout 布局 ， 并 且 在 其 中 放置 了 一 个 TextView 和 一 个 
RadioGroup。RadioGroup 中 含有 三 个 RadioButton。 这 些 组 件 对 应 的 strings.xml 文件 中 定义 的 
变量 为 : 


«string name="radiohe11o"> 你 最 喜欢 的 运动 是 :</string> 
«string name="bascketball ">{kif</string> 
«string name="badminton"> 羽 毛 球 </string> 

«string name="football"> 足 球 </string> 


RadioGroupActivityjava 代码 如 下 : 
package introduction.android.widgetDemo; 


import android.app.Activity; 
import android.os.Bundle; 

import android.widget.RadioButton; 
import android.widget.RadioGroup; 
import android.widget.TextView; 


public class RadioGroupActivity extends Activity { 

private TextView textview; 

private RadioGroup radiogroup; 

private RadioButton radiol,radio2,radio3; 

@Override 

public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState) ; 
setContentView (R.layout.radiogroup) ; 
textview- (TextView) findViewById (R.id.radiohello) ; 
radiogroup- (RadioGroup) findViewById (R.id.radiogroup1) ; 
radiol= (RadioButton) findViewById (R.id.radiobutton1) ; 
radio2= (RadioButton) findViewById (R.id.radiobutton2) ; 
radio3- (RadioButton) findViewById (R.id.radiobutton3) ; 
radiogroup.setOnCheckedChangeListener (new 

RadioGroup.OnCheckedChangeListener()( 
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@Override 
public void onCheckedChanged (RadioGroup group, int checkedId) 


{ 
// TODO Auto-generated method stub 
String text=" 我 最 喜欢 的 运动 是 "; 
if (checkedId==radiol.getId()) { 
text+=radiol.getText ().toString(); 
textview.setText (text) ; 
Jelse if (checkedId==radio2.getId()) { 
text+=radio2.getText().toString(); 
textview.setText (text) ; 
Jelse if (checkedId==radio3.getId()) { 
text+=radio3.getText().toString(); 
textview.setText (text) ; 
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在 RadioGroupActivity 的 onCreate0) 方 法 中 为 RadioGroup 添加 监视 器 RadioGroup. 
OnCheckedChangeListener， 在 其 回调 方法 onCheckedChanged0 中 对 三 个 RadioButton 分 别 进 
行 处 理 。 需 要 说 明 的 是 如 果 把 RadioGroup 去 掉 ， 只 使 用 RadioButton 的 话 ， 则 需要 为 每 个 
RadioButton 单独 设置 监听 器 ， 其 使 用 方法 和 CheckBox 没有 任何 区 别 。 


4.4.7 “下拉 列表 (Spinner) 


Spinner 提 供 下 拉 列 表 式 的 输入 方式 ， 该 方法 可 以 有 效 节省 手机 屏幕 上 的 显示 空间 。 
下 面 用 一 个 简单 的 实例 讲解 Spinner 的 使 用 方法 。 在 工程 WidgetDemo 的 布局 文件 
main.xml 文件 中 添加 一 个 Button， 用 以 启动 SpinnerActivity。 
在 main.xml 中 添加 代码 如 下 : 
<Button 
android: id="@+id/button4" 
android:layout width-"wrap content" 


android:layout height-"wrap content" 
android:text-"SpinnerDemo" /» 


单 击 Button 并 启动 SpinnerActivity 的 代码 如 下 : 


Button spinnerbtn= (Button) this.findViewById (R.id.button4) ; 
spinnerbtn.setOnClickListener (new OnClickListener()( 
@Override 
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public void onClick (View v) ( 
// TODO Auto-generated method stub 
Intent intent-new Intent 
(WidgetDemoActivity.this,SpinnerActivity.class) ; 
startActivity (intent) ; 


mug 


同时 在 AndroidManifest.xml 文件 中 声明 该 Activity: 


<activity android:name=" SpinnerActivity "></activity> 


SpinnerActivity 的 运行 效果 如 图 4.21 所 示 。 


n WidgetDemo 


图 4.21 Spinner 的 应 用 界面 
SpinnerActivity 使 用 的 布局 文件 为 spiner.xml， 其 代码 如 下 : 


<?xml version="1.0" encoding="utf-8"?> 
<LinearLayout 
xmlns:android="http://schemas.android.com/apk/res/android" 
android: layout_width="match_parent" 
android:layout height-"match parent" 
android:orientation-"vertical"» 
<TextView 
android: id="@+id/textView1" 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android: text="textview"/> 
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<Spinner 
android: id="@+id/spinner1" 
android:layout width-"match parent" 
android:layout height-"wrap content" /» 


</LinearLayout> 


SpinnerActivity.java 文件 代码 如 下 : 
package introduction.android.widgetDemo; 


import java.util.ArrayList; 

import java.util.List; 

import android.app.Activity; 
import android.os.Bundle; 

import android.view.MotionEvent; 
import android.view.View; 

import android.widget.AdapterView; 
import android.widget.ArrayAdapter; 
import android.widget.Spinner; 
import android.widget.TextView; 


public class SpinnerActivity extends Activity { 

private List<String>list=new ArrayList<String>() ; 

private TextView textview; 

private Spinner spinnertext; 

private ArrayAdapter<String>adapter; 

public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState) ; 
setContentView (R.layout.spiner) ; 
// 第 一 步 : 定义 下 拉 列 表 内 容 
list.add (" 沈 阳 ") ; 
list.add ("XR"); 
list.add (*JbX(") 
list.add ("上 海 ") 
list.add ("深圳 ") ; 
textview= (TextView) findViewById (R.id.textViewl) ; 
spinnertext= (Spinner) findViewById (R.id.spinnerl) ; 
// 第 二 步 : 为 下 拉 列表 定义 一 个 适配器 
adapter=new ArrayAdapter<String> 

(this, android.R.layout.simple_ spinner item, list) ; 
// 第 三 步 : 设置 下 拉 列 表 下 拉 时 的 菜单 样式 。 
adapter . setDropDownViewResource 
(android.R.layout.simple_spinner_dropdown_item) ; 

// 第 四 步 : 将 适配器 添加 到 下 拉 列 表 上 


spinnertext.setAdapter (adapter) ; 
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// 第 五 步 : 添加 监听 器 ， 为 下 拉 列 表 设置 事件 的 响应 


spinnertext.setOnItemSelectedListener (new 


Spinner .OnItemSelectedListener () { 
public void onItemSelected (AdapterView<?>arg0, View 


argl, int arg2, long arg3) { 
// TODO Auto-generated method stub 
/* 将 所 选 spinnertext 的 值 带 入 myTextView 中 */ 
textview.setText (" 我 来 自 : "tadapter.getItem (arg2) ) ; 


/* 将 spinnertext 显示 */ 
arg0.setVisibility (View. VISIBLE) ; 


i 

public void onNothingSelected (AdapterView<?>arg0) { 
// TODO Auto-generated method stub 
textview.setText ("NONE") ; 
arg0.setVisibility (View.VISIBLE) ; 

) 


3507 
// 将 spinnertext 添加 到 OnTouchListener 对 内 容 选项 触 屏 事件 处 理 


spinnertext.setOnTouchListener (new 


Spinner .OnTouchListener () { 


GOverride 
public boolean onTouch (View v, MotionEvent event) ( 


// TODO Auto-generated method stub 


// Yt mySpinner 隐藏 
v.setVisibility (View.INVISIBLE) ; 


Log.i ("spinner',"Spinner Touch 事件 被 触发 !1") ; 
return false; 


} 
0: 
// 焦 点 改变 事件 处 理 


spinnertext.setOnFocusChangeListener (new 


Spinner .OnFocusChangeListener () { 
public void onFocusChange (View v, boolean hasFocus) { 


// TODO Auto-generated method stub 
v.setVisibility (View. VISIBLE) ; 
Log.i ("spinner","Spinner FocusChange 事件 被 触发 ! ") ; 


3; 


SpinnerActivity 通过 五 个 步骤 将 Spinner 初始 化 并 进行 事件 处 理 。 分 别 为 : 


e 定义 下 拉 列 表 的 列表 项 内 容 List<String>。 
e 为 下 拉 列 表 Spinner 定 义 一 个 适配器 ArrayAdapter<String>， 并 与 列表 项 内 容 相 关联 。 
* 使 用 ArrayAdapter.setDropDownViewResource() 设 置 Spinner 下 拉 列 表 在 打开 时 的 下 拉 
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© 使 用 Spinner. setAdapter() 将 适配器 数据 与 Spinner 关联 起 来 。 


* A Spinner 添加 事件 监听 器 ， 进 行事 件 处 理 。 


Spinner 支持 多 种 事件 处 理 方式 ， 本 实例 中 对 Spinner 被 单 击 事件 、 焦 点 改变 事件 和 
Spinner 的 列表 项 被 选中 事件 进行 了 处 理 。 
在 本 实例 中 ，SpinnerActivity 在 程序 代码 中 动态 建立 了 下 拉 列 表 每 一 项 的 内 容 。 除 此 之 
还 可 以 在 XML 文件 中 定义 Spinner 的 下 拉 列 表 项 ， 步 又 如 下 : 


在 res/values 文件 夹 下 新 建 cities.xml 文件 夹 : 


<?xml version="1.0" encoding="utf-8"?> 
<resources> 
<string-array name="city"> 
<item>shenyang</item> 
<item>nanjing</item> 
<item>beijing</item> 
<item>tianjin</item> 
</string-array> 
</resources> 


在 SpinnerActivity.java 中 初始 化 Spinner: 


Spinner spinner- (Spinner) findViewById 


(R.id.spinner1) ; 


ArrayAdapter<CharSequence>adapter=ArrayAd 


apter.createFromResource (this, R.array.city, 
android.R.layout.simple_spinner_item) ; 


adapter . setDropDownViewResource 


(android.R.layout.simple_spinner_dropdown_ite 
inb) y 


spinner.setAdapter (adapter) ; 


运行 效果 如 图 4.22 所 示 。 


i | WidgetDemo 


ARA : nanjing 


shenyang 
nanjing 
beijing 


tianjin 


图 4.22 Spinner 的 事件 处 理 


4.4.8 ”自动 完成 文本 (AutoCompleteTextView) 


在 使 用 百度 或 者 Google 搜索 信息 时 ， 只 需要 在 搜索 框 中 输入 几 个 关键 字 ， 就 会 有 很 多 相 
关 的 信息 以 列表 形式 被 列举 出 来 供用 户 选择 ， 这 种 效果 在 Android SDK 中 可 以 通过 
AutoCompleteTextView 来 实现 。 
下 面 用 一 个 简单 的 实例 讲解 AutoCompleteTextView 的 使 用 方法 。 在 工程 WidgetDemo 的 
布局 文件 main.xml 中 添加 一 个 Button， 用 以 启动 AutoCompleteTextViewActivity。 


在 main.xml 中 添加 代码 如 下 : 
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<Button 
android: id="@+id/button5" 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:text-"AutoCompleteTextViewDemo" /> 


单 击 Button， 并 启动 AutoCompleteTextViewActivity 的 代码 如 下 : 


Button autobtn= (Button) this.findViewById (R.id.button5) ; 
autobtn.setOnClickListener (new OnClickListener () { 
@Override 
public void onClick (View v) { 
// TODO Auto-generated method stub 
Intent intent=new Intent 
(WidgetDemoActivity.this,AutoCompleteTextViewActivity.class) ; 
startActivity (intent) ; 


-— 
— 


同时 在 AndroidManifest.xml 文件 中 声明 该 Activity: 


<activity android:name=" AutoCompleteTextViewActivity"></activity> 


AutoCompleteTextViewActivity 运行 效果 如 图 4.23 所 示 。 


n WidgetDemo 


hello World 


hello Android 


图 4.23  AutoCompleteTextViewActivity 运行 效果 


AutoCompleteTextViewActivity 使 用 的 布局 文件 为 autocompletetextview.xml， 其 具体 内 容 
如 下 : 
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<?xml version="1.0" encoding="utf-8"?> 
<LinearLayout 
xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout width-"match parent" 
android:layout height-"match parent" 
android:orientation-"vertical"» 
«TextView 
android:layout width-"fill parent" 
android:layout height-"wrap content" 
android: text="AutoCompleteTextView jaz; " /> 


<AutoCompleteTextView 
android: id="@+id/autoCompleteTextView1" 
android: layout_width="match_ parent" 
android: layout_height="wrap_ content" 
android: text=""> 
<requestFocus /> 
</AutoCompleteTextView> 


</LinearLayout> 


AutoCompleteTextViewActivity.java 代码 如 下 : 


package introduction.android.widgetDemo; 


import android.app.Activity; 

import android.os.Bundle; 

import android.widget.ArrayAdapter; 

import android.widget .AutoCompleteTextView; 


public class AutoCompleteTextViewActivity extends Activity { 
private AutoCompleteTextView textView; 
private static final String[] autotext=new String[] 
{"hello", "hello World","hello Android"); 
GOverride 
public void onCreate (Bundle savedInstanceState) ( 
super.onCreate (savedInstanceState) ; 
setContentView (R.layout.autocompletetextview) ; 
textView- (AutoCompleteTextView ) findViewById 
(R.id.autoCompleteTextViewl) ; 
/*new ArrayAdapterd 对 象 将 autotext 字符 串 数组 传 入 * / 
ArrayAdapter<String>adapter=new ArrayAdapter<String> 
(this, android.R.layout.simple_dropdown_item_lline,autotext) ; 
/* 将 ArrayAdapter 添加 到 AutoCompleteTextView 中 */ 
textView.setAdapter (adapter) ; 
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AutoCompleteTextViewActivity 中 为 可 自动 补 全 的 内 容 建立 对 应 字符 串 数 组 autotext， 然 
后 将 该 数组 关联 到 ArrayAdapter 中 ， 然 后 将 ArrayAdapter 与 AutoCompleteTextView 相关 联 ， 
进而 实现 自动 完成 文本 功能 。 
AutoCompleteTextView 提供 一 系列 属性 对 显示 效果 进行 设置 ， 例 如 : 
© completionThreshold: 它 的 值 决定 了 你 在 AutoCompleteTextView 至 少 输入 几 个 字符 ， 
它 才 会 具有 自动 提示 的 功能 。 另 外 默认 最 多 提示 20 条。 
e dropDownAnchor: 它 的 值 是 一 个 View 的 ID， 指 定 后 ，AutoCompleteTextView 会 在 


这 个 View 下 弹出 自动 提示 。 
© dropDownSelector: 应 该 是 设置 自动 提示 的 背景 色 之 类 的 ， 没 有 尝试 过 ， 有 待 进一步 
考证 。 


* dropDownWidth: 设置 自动 提示 列表 的 宽度 。 


4.4.9 ”日 期 选择 器 和 时 间 选 择 器 (DatePicker 和 TimePicker) 


Android SDK 提供 了 DatePicker 和 TimePicker 组 件 ， 分 别 对 日 期 和 时 间 进 行 选择 ， 方 便 
日 期 和 时 间 设 定 。 

下 面 用 一 个 简单 的 实例 讲解 DatePicker 和 TimePicker 组 件 的 使 用 方法 。 在 工程 
WidgetDemo 的 布局 文件 mainxml 中 添加 一 个 名 为 “Date/Timne” 的 Button， 用 以 启动 
TimeActivity。 

在 main.xml 中 添加 代码 如 下 : 


<Button 
android:id-"G«id/buttone" 
android:layout width- "wrap content" 
android:layout height-"wrap content" 
android:text-" Date/Time " /» 


单 击 Button 并 启动 TimeActivity 的 代码 如 下 : 


Button timebtn- (Button) this.findViewById (R.id.buttoné) ; 
timebtn.setOnClickListener (new OnClickListener () { 
GOverride 
public void onClick (View v) { 
// TODO Auto-generated method stub 
Intent intent-new Intent 
(WidgetDemoActivity.this,TimeActivity.class) ; 
startActivity (intent) ; 
} 
HD; 
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同时 在 AndroidManifest.xml 文件 中 声明 该 Activity: 


<activity android:name=" TimeActivity"></activity> 


TimeActivity 运行 效果 如 图 4.24 所 示 。 


P WidgetDemo 


2012/06/05 09:09 


SMTWTFS 


图 4.24 TimeActivity 运行 效果 
TimeActivity 使 用 的 布局 文件 为 time.xml， 其 内 容 如 下 : 


<?xml version-"1.0" encoding-"utf-8"?» 
«LinearLayout 
xmlns:android-"http://schemas.android.com/apk/res/android" 
android:layout width- "match parent" 
android:layout height-"match parent" 
android:orientation-"vertical"» 
«TextView 
android: id="@+id/timeview" 
android: layout_width="fill parent" 
android: layout_height="wrap_content" 
android: text="DatePicker f//TimePicker jJ" /> 
«TimePicker 
android: id="@+id/timepicker" 
android: layout_width="wrap content" 
android: layout_height="116dp" 
android: background="#778888" /> 
<!-- 设置 背景 色 为 墨绿 --> 


<DatePicker 


85 


Android 4.X 从 入 门 到 精通 


android: id="@+id/datepicker" 

android: layout_width="271dp" 

android: layout_height="196dp" 

android: background="#778899" /> 
</LinearLayout> 


TimeActivity.java 的 代码 如 下 : 
package introduction.android.widgetDemo; 
import java.util.Calendar; 


import android.app.Activity; 
import android.os.Bundle; 

import android.widget.DatePicker; 
import android.widget.TextView; 
import android.widget.TimePicker; 


public class TimeActivity extends Activity { 
private TextView textview; 
private TimePicker timepicker; 
private DatePicker datepicker; 
/* 声明 日 期 及 时 间 变 量 */ 
private int year; 
private int month; 
private int day; 
private int hour; 
private int minute; 


@override 

public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState) ; 
setContentView (R.layout.time) ; 
/* 获取 当前 日 期 及 时 间 */ 
Calendar calendar=Calendar.getInstance() ; 
year=calendar.get (Calendar.YEAR) ; 
month=calendar.get (Calendar.MONTH) ; 
day=calendar.get (Calendar.DAY OF MONTH) ; 
hour=calendar.get (Calendar.HOUR) ; 
minute-calendar.get (Calendar.MINUTE) ; 
datepicker- (DatePicker) findViewById (R.id.datepicker) 
timepicker- (TimePicker) findViewById (R.id.timepicker) 
/* WE TextView 对 象 ， 显 示 初 始 日 期 时 间 */ 
textview- (TextView) findViewById (R.id.timeview) ; 
textview.setText (new StringBuilder().append (year) .append ("/") 

-append (format (month+1) ) .append ("/") .append (format (day) ) 
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.append (" ") .append (format (hour) ) .append (":") 
.append (format (minute) ) ) ; 
/* i& E OnDateChangedListener () */ 
datepicker.init (year, month, day, 
new DatePicker.OnDateChangedListener()( 
@Override 
public void onDateChanged (DatePicker view, int year, 
int monthOfYear, int dayOfMonth) { 
// TODO Auto-generated method stub 
TimeActivity.this.year=year; 
month=monthofYear; 
day-dayOfMonth; 
textview.setText (new StringBuilder().append (year) 
.append ("/") .append (format (month+1) ) 
.append ("/") .append (format (day) ) .append (" 
2M 
.append (format (hour) ) .append (":") 
.append (format (minute) ) ) ; 
} 
DER 
timepicker.setOnTimeChangedListener (new 
TimePicker.OnTimeChangedListener() 
{ 


@Override 
public void onTimeChanged (TimePicker view, int hourOfDay, 
int minute) 


// TODO Auto-generated method stub 

hour-hourOfDay; 

TimeActivity.this.minute=minute; 

textview.setText (new StringBuilder().append (year) 
.append ("/") .append (format (month+1) ) 

.append ("/") .append (format (day) ) .append (" ") 
.append (format (hour) ) .append (":") 

.append (format (minute) ) ) ; 


Dg 


private String format (int time) { 
String str=""+time; 
if (str.length()==1) 
str="0"+str; 
return str; 
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H 
} 


TimeActivity 中 使 用 java.util.Calendar 对 象 获取 当前 系统 时 间 。 当 更 改 DatePicker 组 件 中 
的 日 期 时 ， 会 触发 DatePicker 的 OnDateChange0 事 件 ， 当 修改 TimePacker 的 时 间 时 ， 会 触发 
TimePacker 的 OnDateChangeQ E . 

由 本 实例 可 见 ，DatePicker 实现 OnDateChangedListener 监听 器 的 方法 与 TimePicker 实现 
setOnTimeChangedL istener 监听 器 的 方法 有 所 类 似 。DatePicker 用 init0 方 法 设 定年 、 月 、 日 的 
同时 设 定 监听 器 ， 而 TimePicker 使 用 setOnTimeChangedListener() El Pz W $E o 


4.4.10 ”进度 条 (ProgressBar) 


当 应 用 程序 在 后 台 运 行 时 ， 可 以 使 用 进度 条 反馈 给 用 户 当 前 的 进度 信息 。 进 度 条 被 用 以 

显示 当前 应 用 程序 运行 状况 ， 功 能 完成 多 少 等 情况 。Android SDK 提供 两 种 样式 的 进度 条 ， 
-种 是 圆 形 的 进度 条 ， 另 一 种 是 水 平 进度 条 。 其 中 圆 形 进度 条 分 大 、 中 、 小 三 种 。 

进度 条 本 质 上 是 一 个 整数 ， 显 示 当 前 的 整数 值 在 特定 范围 内 的 比重 。 下 面 用 一 个 简单 的 
实例 讲解 ProgressBar 组 件 的 使 用 方法 。 

在 工程 WidgetDemo 的 布局 文件 main.xml 中 添加 一 个 名 为 ProgressBarDemo 的 Button, 
用 以 启动 ProcessBarActivity。 

在 main.xml 中 添加 代码 如 下 : 


<Button 
android:id="@+id/button7" 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:text-"ProgressBarDemo" /» 


单 击 Button 并 启动 ProcessBarActivity 的 代码 如 下 : 


Button processbtn- (Button) this.findViewById (R.id.button7) ; 
processbtn.setOnClickListener (new OnClickListener()( 
@Override 
public void onClick (View v) { 
// TODO Auto-generated method stub 
Intent intent=new Intent 
(WidgetDemoActivity.this,ProcessBarActivity.class) ; 
startActivity (intent) ; 
} 
De 


同时 在 AndroidManifest.xml 文件 中 声明 该 Activity: 
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<activity android:name="ProcessBarActivity"></activity> 


ProcessBarActivity 运行 效果 如 图 4.25 所 示 。 


@ 10:58 


P WidgetDemo 


图 4.25 ProcessBarActivity 运行 效果 
ProcessBarActivity 使 用 的 布局 文件 为 processbarxml， 其 内 容 如 下 : 


<?xml version-"1.0" encoding-"utf-8"?» 
«LinearLayout 
xmlns:android-"http://schemas.android.com/apk/res/android" 
android:layout width- "match parent" 
android:layout height-"match parent" 
android:orientation-"vertical"» 
«ProgressBar 
android: id="@+id/progressBar1" 
style-"?android:attr/progressBarStyleSmall" 
android:layout width-"wrap content" 
android:layout height-"wrap content" /» 


«ProgressBar 
android: id="@+id/progressBar2" 
android: layout_width="wrap_ content" 
android: layout_height="wrap content" /> 


<ProgressBar 
android: id="@+id/progressBar3" 
style="?android:attr/progressBarStyleLarge" 
android: layout_width="wrap_ content" 
android: layout_height="wrap_ content" /> 
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<ProgressBar 
android: id="@+id/progressBar4" 
style="?android:attr/progressBarStyleHorizontal" 
android: layout_width="209dp" 
android: layout_height="30dp" 
android:max="100"/> 


</LinearLayout> 


该 布局 中 放置 了 小 、 中 、 大 三 种 类 型 的 圆 形 进度 条 各 一 个 ， 以 及 一 个 水 平 放 置 的 条 形 进 
度 条 。 一 般 情 况 下 ， 开 发 人 员 不 会 为 圆 形 进度 条 指定 进度 ， 圆 形 进度 条 只 是 展示 运行 效果 ， 
而 不 反映 实际 的 进度 。 水 平 进度 条 则 不 同 ， 开 发 人 员 会 为 条 形 进 度 条 指定 最 大 值 ， 以 及 进度 
条 当前 值 的 获取 方法 。 在 本 实例 中 ， 条 形 进度 条 的 最 大 值 为 100。 

ProcessBarActivity.java 代码 如 下 : 


package introduction.android.widgetDemo; 


import android.app.Activity; 
import android.os.Bundle; 

import android.os.Handler; 

import android.widget .ProgressBar; 


public class ProcessBarActivity extends Activity { 
ProgressBar progressBar; 
int i=0; 
int progressBarMax=0; 
/* 创建 Handler X$ */ 
Handler handler=new Handler (); 


@Override 
public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState) ; 
setContentView (R.layout.processbar) ; 
progressBar= (ProgressBar) findViewById (R.id.progressBar4) ; 
/* 获取 最 大 值 */ 
progressBarMax=progressBar .getMax() ; 
/* 匿名 内 部 类 启动 实现 效果 的 线程 */ 
new Thread (new Runnable() { 
@Override 
public void run() { 
while (i++<progressBarMax) { 
// 设置 滚动 条 当前 状态 值 


progressBar.setProgress (i) ; 
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Thread.sleep (15) ; 


try { 


} catch (Exception e) { 
e.printStackTrace(); 
} 


} 
}) start(); 


5 
5 
ProcessBarActivity 对 水 平 进度 条 进行 了 处 理 。 先 获取 了 水 平 进度 条 的 最 大 值 ， 然 后 启动 
了 一 个 线程 ， 由 该 线程 来 控制 进度 条 的 值 ， 从 0 开始 ， 每 隔 15 毫秒 增加 1。 


4.4.11 ”滚动 视图 (ScrollView) 

当 Activity 提供 的 用 户 界面 上 有 很 多 内 容 ， 以 致 当前 手机 屏幕 不 能 完全 显示 全 部 内 容 
时 ， 就 需要 滚动 视图 来 帮助 浏览 全 部 的 内 容 。 

以 工程 WidgetDemo 为 例 ， 由 于 在 讲述 过 程 中 不 断 地 在 main.xml 文件 中 添加 按钮 和 其 他 
组 件 ， 目 前 已 经 不 能 显示 全 部 内 容 ， 效 果 如 图 4.26 所 示 。 


P WidgetDemo 
Hello World, WidgetDemoActivity! 


Button 


CheckBoxDemo 
RadioGroupDemo 


SpinnerDemo 


AutoCompleteTextViewDemo 


Date/Time 


PrnnressRarnemn 


图 4.26 添加 大 量 组 件 后 的 效果 


这 时 候 就 需要 使 用 ScrollView， 即 将 当前 的 Activity 的 视图 转化 为 滚动 视图 ， 以 便于 浏 
览 。ScrollView 的 使 用 非常 方便 ， 只 需 在 main.xml 的 <LinearLayout> 标 签 外 面 加 上 ScrollView 
组 件 的 声明 即 可 。 布 局 文件 main.xml 的 内 容 如 下 : 
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<ScrollView 
xmlns:android-"http://schemas.android.com/apk/res/android" 
android:layout width-"fill parent" 
android: layout_height="fill_parent"> 
<LinearLayout>....</LinearLayout> 
</ScrollView> 


添加 ScrollView Ja, main.xml 布局 的 运行 效果 如 图 4.27 所 示 。 


图 WidgetDemo 


Button 


CheckBoxDemo 
RadioGroupDemo 
SpinnerDemo 
AutoCompleteTextViewDemo 
Date/Time 


ProgressBarDemo 


图 4.27  ScrollView 的 运行 效果 


4.4.12 ” 拖 动 条 (SeekBar) 


SeekBar 是 水 平 进度 条 ProgressBar 的 间接 子 类 ， 相 当 于 一 个 可 以 拖 动 的 水 平 进度 条 。 下 
面 仍 以 一 个 简单 的 实例 讲解 SeekBar 组件 的 使 用 方法 。 
在 工程 WidgetDemo 的 布局 文件 main.xml 中 添加 一 个 名 为 “SeekBarDemo” 的 Button, 
用 以 启动 SeekBarActivity。 
在 main.xml 中 添加 代码 如 下 : 
<Button 
android:id="@+id/button8" 
android:layout width-"wrap content" 


android:layout height-"wrap content" 
android:text-"SeekBarDemo" /» 


单 击 Button 并 启动 SeekBarActivity 的 代码 如 下 : 


Button processbtn- (Button) this.findViewById (R.id.button8) ; 
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processbtn.setOnClickListener (new OnClickListener()( 
@Override 
public void onClick (View v) { 
// TODO Auto-generated method stub 


Intent intent=new Intent (WidgetDemoActivity.this, 
SeekBarActivity.class) ; 
startActivity (intent) ; 
TOUT 
同时 在 AndroidManifest.xml 文件 中 声明 该 Activity: 


<activity android:name="SeekBarActivity"></activity> 


SeekBarActivity 运行 效果 如 图 4.28 所 示 。 


n WidgetDemo 
当前 进度 为 : 41 


一 -一 


图 4.28  SeekBarActivity 运行 效果 


SeekBarActivity 使 用 的 布局 文件 为 seekbarxml， 其 内 容 如 下 : 


<?xml version="1.0" encoding="utf-8"?> 
<LinearLayout 
xmlns:android- "http://schemas.android.com/apk/res/android" 
android:layout width- "match parent" 
android:layout height-"match parent" 
android:orientation-"vertical"» 


«TextView 
android: id="@+id/textViewl1" 
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android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:text-"TextView" /» 


«SeekBar 
android: id="@+id/seekBar1" 
android:layout width-"match parent" 
android:layout height-"wrap content" 
android:max-"100"/» 


«/LinearLayout» 


该 文件 确定 SeekBar 对 象 的 最 大 值 为 100， 宽 度 为 手机 屏幕 的 宽度 。 
SeekBarActivity.java 的 代码 如 下 : 


package introduction.android.widgetDemo; 


import android.app.Activity; 
import android.os.Bundle; 
import android.util.Log; 
import android.widget.SeekBar; 
import android.widget.TextView; 


public class SeekBarActivity extends Activity { 
private TextView textView; 
private SeekBar seekBar; 
@Override 
public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState) ; 
setContentView (R.layout.seekbar) ; 
textView= (TextView) findViewById (R.id.textViewl) ; 
seekBar= (SeekBar) findViewById (R.id.seekBarl) ; 
/* 设置 SeekBar 监听 setonSeekBarChangeListener */ 
SeekBar.setOnSeekBarChangeListener (new 
SeekBar .OnSeekBarChangeListener () { 
/* 拖 动 条 停止 拖 动 的 时 调用 */ 
@Override 
public void onStopTrackingTouch (SeekBar seekBar) { 
Log.i ("SeekBarRctivity"，" 拖 动 停止 ") ; 
} 
/* 拖 动 条 开始 拖 动 的 时 调用 */ 
@Override 
public void onStartTrackingTouch (SeekBar seekBar) { 
Log.i ("SeekBarRActivity"，“" 开 始 拖 动 ") ; 
} 
/* 拖 动 条 进度 改变 的 时 调用 */ 
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public void onProgressChanged (SeekBar seekBar, int 


progress, 

boolean fromUser) { 

/* 拖 动 条 进度 改变 的 时 调用 */ 

textView.setText ("当前 进度 为 : "4progress*"$") ; 

} 
Di 
5 
} 


SeekBar 的 事件 处 理 接口 为 OnSeekBarChangeListener， 该 监 昕 器 提供 对 三 种 事件 的 监 
听 ， 分 别 为 当 SeekBar 的 拖 动 条 开始 被 拖 动 时 、 拖 动 条 拖 动 停 止 时 和 拖 动 条 的 位 置 发 生 改变 
时 。SeekBarActivity 在 拖 动 条 开始 被 拖 动 和 拖 动 停止 时 ， 会 通过 Logcat 打印 相关 信息 。 当 拖 
动 条 位 置 发 生 改 变 时 ， 将 当前 的 数值 显示 到 TextView 中 。 


4.4.13 ”评价 条 (RatingBar) 


在 网 上 购物 的 时 候 ， 经 常会 对 所 购买 商品 进行 打分 的 情况 。 一 般 对 商品 的 评价 和 打分 是 
以 五 个 星星 的 方式 进行 的 。Android SDK 提供 了 RatingBar 这 个 组 件 来 实现 该 功能 。 

RatingBar 是 SeekBar 和 ProgressBar 的 扩展 ， 是 ProgressBar 的 间接 子 类 ， 可 以 使 用 
ProgressBar 相关 的 属性 。RatingBar 有 三 种 风格 分 别 为 : 默认 风格 〈ratingBarStyle) 、 小 风格 
CratingBarStyleSmall) 、 大 风格 (ratingBarStyleIndicator ) 。 其 中 ， 默 认 风 格 的 RatingBar 是 
我 们 通常 使 用 的 ， 可 以 进行 交互 ， 而 其 他 两 种 不 能 进行 进行 交互 。 

以 一 个 简单 的 实例 讲解 RatingBar 组 件 的 使 用 方法 。 在 工程 WidgetDemo 的 布局 文件 
main.xml 中 添加 一 个 名 为 “RatingBarrDemo” 的 Button， 用 以 启动 RatingBarActivity。 

在 main.xml 中 添加 代码 如 下 : 

<Button 

android:id="@+id/button9" 
android:layout width-"wrap content" 


android:layout height-"wrap content" 
android:text-"RatingBarDemo" /» 


单 击 Button 并 启动 RatingBarActivity 的 代码 如 下 : 


Button ratingbarbtn- (Button) this.findViewById (R.id.button9) ; 
ratingbarbtn.setOnClickListener (new OnClickListener () { 
GOverride 
public void onClick (View v) ( 
// TODO Auto-generated method stub 
Intent intent-new Intent 
(WidgetDemoActivity.this,RatingBarActivity.class) ; 
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startActivity (intent) ; 


5 


同时 在 AndroidManifest.xml 文件 中 声明 该 Activity: 
<activity android:name="RatingBarActivity"></activity> 
RatingBarActivity 运行 效果 如 图 4.29 所 示 。 


EE @ 10:01 


r WidgetDemo 
选择 了 3.5 个 星星 


kk kkk 


图 4.29 RatingBarActivity 运行 效果 
RatingBarActivity 使 用 的 布局 文件 ratingbarxml 内 容 如 下 : 


<?xml version-"1.0" encoding-"utf-8"?» 
«LinearLayout 
xmlns:android-"http://schemas.android.com/apk/res/android" 
android:layout width- "match parent" 
android:layout height-"match parent" 
android:orientation-"vertical"» 


«TextView 
android: id="@+id/textView1" 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:text-"TextView" /> 


«RatingBar 
android: id="@+id/ratingBar1" 
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android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:numStars- "5" 
android:stepSize-"0.5" 
android:rating-"3"/» 


</LinearLayout> 


该 布局 文件 使 用 LinearLayout 布局 ， 其 中 放置 了 一 个 TextView 和 一 个 RatingBar, Jf xt 
RatingBar 的 相关 属性 进行 了 设置 。android:numStars="5" 用 于 设置 RatingBar 显示 的 星星 数量 
为 5 个 ; android:stepSize="0.5" 用 于 设置 RatingBar 的 最 小 变化 单位 为 半 个 星星 ;android:rating 
="3" 表 示 RatingBar 在 初始 状态 下 被 选中 的 星星 数量 为 3 个。 

RatingBarActivity.java 代码 如 下 : 


package introduction.android.widgetDemo; 


import android.app.Activity; 

import android.os.Bundle; 

import android.util.Log; 

import android.view.MotionEvent; 

import android.view.View; 

import android.view.View.OnTouchListener; 

import android.widget.RatingBar; 

import android.widget.RatingBar.OnRatingBarChangeListener; 
import android.widget.TextView; 

import android.widget.Toast; 


public class RatingBarActivity extends Activity { 

private RatingBar chooseRatingBar; 

private TextView textView; 

@Override 

public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState) 
setContentView (R.layout.ratingbar) 
textView= (TextView) findViewById (R.id.textViewl) ; 
chooseRatingBar= (RatingBar) findViewById (R.id.ratingBar1) ; 


; 
; 


/* 创 建 RatingBar 监听 器 */ 
chooseRatingBar.setOnRatingBarChangeListener (new 
OnRatingBarChangeListener () { 


@Override 
public void onRatingChanged (RatingBar ratingBar, float 
rating, boolean fromUser) { 
chooseRatingBar= (RatingBar) findViewById 
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(R.id.ratingBar1) ; 
chooseRatingBar.setRating (rating) ; 
textView.setText (" 您 选择 了 "+Tating+" 个 星星 ") ; 


0308 


RatingBarActivity 为 RatingBar 对 象 设 置 了 OnRatingBarChangeListener 监听 器 ， 当 用 户 单 
击 RatingBar 引起 被 选中 星星 数量 的 变化 时 ， 该 接口 会 监测 到 该 事件 ， 并 且 调 用 
onRatingChanged() 方 法 ， 更 新 TextView 显示 的 内 容 。 

onRatingChanged() 的 三 个 参数 所 对 应 的 含义 为 : 


* ratingBar: 多 个 RatingBar 可 以 同时 指定 同一 个 RatingBar 监听 器 。 该 参数 就 是 当前 触 
发 RatingBar 监听 器 的 那 一 个 RatingBar 对 象 。 

© rating: 当前 评级 分 数 。 取 值 范围 从 0 到 RatingBar 的 总 星星 数 。 

* fromUser: 如 果 触 发 监听 器 的 是 来 自用 户 触 屏 单 击 或 轨迹 球 左右 移动 ， 则 为 true. 


44.14 ”图 片 视图 (lImageView) 和 图 片 按 钮 (ImageButton) 


ImageView 是 用 于 显示 图 片 的 组 件 ， 在 很 多 场合 都 有 比较 普遍 的 使 用 。ImageView 可 以 
显示 任意 图 像 ， 加 载 各 种 来 源 的 图 片 ( 如 资源 或 图 片 库 ) 。ImageView 可 以 负责 计算 图 片 的 
尺寸 以 便 在 任意 的 布局 中 使 用 ， 并 且 可 以 提供 缩放 或 者 着 色 等 选项 供 开发 者 使 用 。 

ImageButton 是 ImageView 的 子 类 ， 相 当 于 一 个 表明 是 图 片 而 不 是 文字 的 Button。 其 使 用 
方法 和 Button 完全 相同 。 

下 面 通 过 一 个 实例 来 了 解 一 下 这 两 个 组 件 的 使 用 方法 。 在 工程 WidgetDemo 的 布局 文件 
main.xml 中 添加 一 个 名 为 ImageButtonDemo 的 Button， 用 以 启动 ImageButtonActivity. 

在 main.xml 中 添加 代码 如 下 : 

<Button 

android:id="@+id/button10" 
android:layout width-"wrap content" 


android:layout height-"wrap content" 
android:text-"ImageButtonDemo" /» 


"ick Button 并 启动 RatingBarActivity 的 代码 如 下 : 


Button imgbtn- (Button) this.findViewById (R.id.button10) ; 
imgbtn.setOnClickListener (new OnClickListener () { 
@Override 
public void onClick (View v) { 
// TODO Auto-generated method stub 
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Intent intent=new Intent 
(WidgetDemoActivity.this, ImageButtonActivity.class) ; 
startActivity (intent) ; 


~ 
— 


同时 在 AndroidManifest.xml 文件 中 声明 该 Activity: 
<activity android:name="ImageButtonActivity"></activity> 
ImageButtonActivity 运行 效果 如 图 4.30 所 示 。 


@ 11:46 


P WidgetDemo 


图 4.30  ImageButtonActivity 运行 效果 
ImageButtonActivity 的 布局 文件 imgbtn.xml 内 容 如 下 : 


<?xml version-"1.0" encoding-"utf-8"?» 
«LinearLayout 
xmlns:android-"http://schemas.android.com/apk/res/android" 
android:layout width- "match parent" 
android:layout height-"match parent" 
android:orientation-"vertical"» 


«ImageView 
android: id="@+id/imageView1" 
android: layout_width="250dp" 
android: layout_height="250dp" 
android:src="@drawable/girl" /> 
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<ImageButton 
android: id="@+id/imageButton1" 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:src-"edrawable/ic launcher" /» 


«/LinearLayout» 


该 文件 使 用 LinearLayout 布局 ， 其 中 放 入 了 一 个 ImageView 组 件 ， 一 个 ImageButton 组 
件 。 两 个 组 件 都 通过 android:sre 属性 指定 了 显示 的 图 片 。 该 实例 用 到 了 两 个 图 片 资源 ， 一 个 
为 girl， 一 个 为 ic launcher. HF Android 会 根据 手机 设备 的 配置 高 低 选择 不 同 的 资源 ， 因 此 
为 了 应 用 程序 的 通用 性 ， 在 三 个 drawable 文件 夹 下 ， 都 放置 了 girl.gif 图 像 。ic_launcherpng 
是 系统 自 带 的 资源 文件 。 
& res 
drawable-hdpi 
国 girl.gif 
Ma) ic launcher.png 
@ drawable-ldpi 


($8 girl.gif 

[| ic launcher.png 
@ drawable-mdpi 

国 girl.gif 

[| ic launcher.png 


图 4.31 工程 中 的 图 片 资 源 
ImageButtonActivity.java 代码 如 下 : 


package introduction.android.widgetDemo; 
import android.app.Activity; 
import android.os.Bundle; 
import android.view.View; 
import android.view.ViewGroup.LayoutParams; 
import android.widget .ImageButton; 
import android.widget.ImageView; 
public class ImageButtonActivity extends Activity { 
private ImageButton imgbtn; 
private ImageView imgview; 
GOverride 
protected void onCreate (Bundle savedInstanceState) { 
// TODO Auto-generated method stub 
super.onCreate (savedInstanceState) ; 
setContentView (R.layout.imgbtn) ; 
imgbtn- (ImageButton) this.findViewById (R.id.imageButtonl) ; 
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imgview- (ImageView) this.findViewById (R.id.imageView1) ; 
imgbtn.setOnClickListener (new View.OnClickListener () { 
@override 
public void onClick (View v) { 
// TODO Auto-generated method stub 
LayoutParams params=imgview.getLayoutParams () ; 
params .height+=3; 
params .width+=3; 
imgview.setLayoutParams (params) ; 


2255 
H 


ImageButtonActivity 为 ImageButton 添加 了 单 击 监听 器 ， 对 用 户 单 击 imgbtn 的 事件 进行 
了 处 理 。 每 次 用 户 单 击 图 片 按钮 ， 都 把 ImageView 组 件 的 宽 和 高 增 大 3。 随 着 用 户 的 不 断 单 
击 ，ImageView 中 显示 的 图 片 越 来 越 大 ， 显 示 了 ImageView 组 件 对 图 片 的 缩放 功能 。 


4.4.15 ”图 片 切换 器 ImageSwitcher 和 图 库 Gallery 


在 使 用 Android 手机 设置 壁纸 的 时 候 ， 会 看 到 屏幕 底部 有 很 多 可 以 滚动 的 图 片 ， 当 单 击 
某 一 图 片 时 ， 在 其 上 面 的 空间 会 显示 当前 选中 的 图 片 ， 此 时 我 们 用 到 的 就 是 Gallery 和 
ImageSwitcher。 

Gallery 组 件 用 于 横向 显示 图 像 列 表 ， 并 且 自 动 将 当前 图 像 放置 到 中 间 位 置 。 
ImageSwitcher 则 像 是 图 片 浏览 器 ， 可 以 切换 图 片 ， 通 过 它 可 以 制作 简单 的 约 灯 片 等 等 。 通 常 
将 这 两 个 类 结合 在 一 起 使 用 ， 可 以 制作 有 一 定 效 果 的 相册 。 

下 面 通过 一 个 实例 来 了 解 一 下 这 两 个 组 件 的 使 用 方法 。 

在 工程 WidgetDemo 的 布局 文件 main.xml 中 添加 一 个 名 为 GalleryDemo 的 Button, H LA 
启动 GalleryActivity。 在 main.xml 中 添加 代码 如 下 : 

<Button 

android: id="@+id/button11" 
android:layout width-"wrap content" 


android:layout height-"wrap content" 
android:text-"GalleryDemo" /» 


单 击 Button 并 启动 GalleryActivity 的 代码 如 下 : 


Button gallerybtn- (Button) this.findViewById (R.id.buttoni1) ; 
gallerybtn.setOnClickListener (new OnClickListener()( 
@Override 
public void onClick (View v) { 
// TODO Auto-generated method stub 
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Intent intent=new Intent 
(WidgetDemoActivity.this,GalleryActivity.class) ; 
startActivity (intent) ; 
DE 
同时 在 AndroidManifest.xml 文件 中 声明 该 Activity: 


<activity android:name="GalleryActivity"></activity> 


GalleryActivity 运行 效果 如 图 4.32 所 示 。 


图 4.32 GalleryActivity 运行 效果 


GalleryActivity 使 用 的 布局 文件 为 gallery.xml， 内 容 如 下 : 


<?xml version="1.0" encoding="utf-8"?> 
<RelativeLayout 
xmlns:android-"http://schemas.android.com/apk/res/android" 
android:layout width-"fill parent" 
android:layout height-"fill parent" 
android:orientation-"vertical"» 
«ImageSwitcher 
android: id="@+id/switcher" 
android: layout_width="match_parent" 
android:layout height-"match parent" 
android:layout alignParentTop-"true" 
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android: layout_alignParentLeft="true"> 
</ImageSwitcher> 
<Gallery 
android: id="@+id/gallery" 
android: background=" #333333" 
android: layout_width="fill_parent" 
android: layout_height="60dp" 
android: layout_alignParentBottom="true" 
android: layout_alignParentLeft="true" 
android:gravity-"center vertical" 
android:spacing-"16dp" /» 
«/RelativeLayout» 


该 布局 文件 使 用 的 是 相对 布局 ， 通 过 android:layout alignParentTop-"true" iX A JE PEAS 
ImageSwitcher 放置 于 视图 的 顶端 ， 其 顶部 与 其 父 组 件 的 顶部 对 齐 ， 同 时 使 用 android: 
layout_alignParentLeft="true" 这 个 属性 使 ImageSwitcher 的 左边 缘 与 其 父 组 件 的 左边 缘 对 齐 。 
在 设置 Gallery 组 件 时 ， 将 其 与 屏幕 的 左下 角 对 其 ，android:layout_alignParentBottom="true" 是 
将 该 组 件 的 底部 与 其 父 组 件 的 底部 对 齐 ， 并 且 使 用 android:spacing="16dp" 属 性 设置 了 图 片 之 
间 的 间距 。 

GalleryActivityjava 代码 如 下 : 


package introduction.android.widgetDemo; 


import android.app.Activity; 

import android.content.Context; 

import android.os.Bundle; 

import android.view.View; 

import android.view.ViewGroup; 

import android.view.ViewGroup.LayoutParams; 
import android.view.animation.AnimationUtils; 
import android.widget .AdapterView; 

import android.widget.AdapterView.OnItemSelectedListener; 
import android.widget .BaseAdapter; 

import android.widget.Gallery; 

import android.widget.ImageSwitcher; 

import android.widget.ImageView; 

import android.widget.ViewSwitcher.ViewFactory; 


public class GalleryActivity extends Activity { 
private Gallery gallery; 
private ImageSwitcher imageSwitcher; 
private int[] resids=new int[] { 
R.drawable.sample_0, R.drawable.sample 1, 
R.drawable.sample 2, R.drawable.sample 3, 
R.drawable.sample 4, R.drawable.sample 5, 
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R.drawable.sample 6, R.drawable.sample 7); 
GOverride 
public void onCreate (Bundle savedInstanceState) ( 
super.onCreate (savedInstanceState) ; 
setContentView (R.layout.gallery) ; 
/* li Gallery fllImageSwitcher */ 
gallery- (Gallery) findViewById (R.id.gallery) ; 
imageSwitcher- (ImageSwitcher) findViewById (R.id.switcher) ; 
/* 创建 用 于 描述 图 像 数 据 的 ImageAdapter 对 象 */ 
ImageAdapter imageAdapter=new ImageAdapter (this) ; 
/* WH Gallery 组 件 的 Adapter WH */ 
gallery.setAdapter (imageAdapter) ; 
/* 添加 Gallery 监听 器 */ 
gallery.setOnItemSelectedListener (new 
OnItemSelectedListener () { 


@Override 
public void onItemSelected (AdapterView<?>parent, View 
view, 
int position, long id) { 
// TODO Auto-generated method stub 
// 当选 取 Grallery 上 的 图 片 时 ， 在 ImageSwitcher 组 件 中 显 
示 该 图 像 


imageSwitcher.setImageResource 
(resids[position]) ; 


} 


@Override 
public void onNothingSelected (AdapterView<?>arg0) { 
// TODO Auto-generated method stub 


De: 
/* 设置 ImageSwitcher 组 件 的 工厂 对 象 */ 
imageSwitcher.setFactory (new ViewFactory() { 
/* ImageSwitcher 用 这 个 方法 来 创建 一 个 View 对象 去 显示 图 片 */ 
@Override 
public View makeView() { 
// TODO Auto-generated method stub 
ImageView imageView=new ImageView 
(GalleryActivity.this) ; 
/* setScaleType 可 以 设置 当 图 片 大 小 和 容器 大 小 不 匹配 时 的 剪 
辑 模式 */ 
imageView.setScaleType 
(ImageView.ScaleType.FIT_CENTER) ; 
imageView.setLayoutParams (new 
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LayoutParams.FILL PARENT, 


ImageSwitcher.LayoutParams ( 


LayoutParams.FILL PARENT) ) ; 
return imageView; 


YR 
/* KH ImageSwitcher 组 件 显示 图 像 的 动画 效果 */ 


imageSwitcher.setInAnimation (AnimationUtils.loadAnimation 


android.R.anim.fade in) ) ; 
imageSwitcher.setOutAnimation (AnimationUtils.loadAnimation 


android.R.anim.fade out) ) ; 


public class ImageAdapter extends BaseAdapter { 
/* ÆX Context */ 
private Context mContext; 


/* 声明 ImageAdapter */ 
public ImageAdapter (Context context) { 
mContext-context; 


@Override 

/* 获取 图 片 的 个 数 */ 

public int getCount(){ 
// TODO Auto-generated method stub 
return resids.length; 


/* 获取 图 片 在 库 中 的 位 置 */ 

@Override 

public Object getItem (int position) { 
// TODO Auto-generated method stub 
return position; 


/* 获取 图 片 ID */ 

@Override 

public long getItemId (int position) { 
// TODO Auto-generated method stub 
return position; 
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/* 返回 具体 位 置 的 ImageView 对 象 */ 
@Override 
public View getView (int position, View convertView, ViewGroup 
parent) { 
ImageView imageview=new ImageView (mContext) ; 
/* 给 ImageView 设置 资源 */ 
imageview.setImageResource (resids[position]) ; 
/* 设置 图 片 布局 大 小 为 100*100 */ 
imageview.setLayoutParams (new Gallery.LayoutParams 
(1100701000) 
/* 设置 显示 比例 类 型 */ 
imageview.setScaleType (ImageView.ScaleType.FIT XY) ; 
return imageview; 


i 


Gallery 要 显示 的 图 片 来 自 资源 文件 。 把 需要 显示 的 图 片 放 在 /res/drawable 目录 下 后 ， 将 
这 些 图 片 的 ID 保存 在 一 个 int 数 组 中 以 备 使 用 。 相 关 代 码 如 下 : 
private int[] resids=new int[] { 
R.drawable.sample 0, R.drawable.sample 1, 
R.drawable.sample 2, R.drawable.sample 3, 


R.drawable.sample 4, R.drawable.sample 5, 
R.drawable.sample 6, R.drawable.sample 7); 


Gallery 通过 setAdapter (imageAdapter) 方法 将 组 件 和 要 显示 的 图 片 关 联 起 来 。 本 实例 中 
为 Gallery 设 定 的 适配器 为 ImageAdapter， 主 要 用 于 描述 图 像 信 息 ， 其 为 android.widget. 
BaseAdapter 的 子 类 。 

在 ImageAdapter 类 中 有 两 个 方法 值得 我 们 注意 ， 其 中 一 个 是 getCount0 方 法 ， 它 用 于 返 
回 图 片 的 总 数 ， 通 常 使 用 获取 存放 图 片 数 组 长 度 的 方法 获取 图 片 总 数 ， 也 可 以 规定 具体 的 返 
回 数 ， 但 不 能 超过 实际 图 片 数 量 ，getView0 方 法 是 当 Gallery 中 需要 显示 某 一 个 图 像 时 ， 将 当 
前 图 片 的 索引 ， 也 就 是 position 的 值 传 入 ， 从 resids 数组 中 获得 相应 的 图 片 的 ID. 

GalleryActivity 为 添加 Gallery 监听 器 ， 处 理 了 用 户 单 击 Gallery 中 图 片 的 事件 ， 并 设置 
ImageSwitcher 相关 属性 。 其 中 代码 如 下 : 


imageSwitcher.setInAnimation (AnimationUtils.loadAnimation (this, 
android.R.anim.fade in) ) ; 


imageSwitcher.setOutAnimation (AnimationUtils.loadAnimation (this, 
android.R.anim.fade_out) ) ; 


设置 了 ImageSwitcher 组 件 图 片 切换 时 的 渐 入 和 渐 出 效果 。 
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44.16 ”网 格 视图 (GridView) 


GridView 提供 了 一 个 二 维 的 可 滚动 的 网 格 ， 按 照 行列 的 方式 来 显示 内 容 ， 一 般 适 合 显示 
图 标 、 图 片 等 ， 适 合 浏览 。 

下 面 通过 一 个 实例 来 了 解 一 下 GridView 组 件 的 使 用 方法 。 在 工程 WidgetDemo 的 布局 文 
件 main.xml 中 添加 一 个 名 为 GridViewDemo 的 Button， 用 以 启动 GridViewActivity。 

在 main.xml 中 添加 代码 如 下 : 


<Button 
android: id="@+id/button12" 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:text-"GridViewDemo" /> 


单 击 Button 并 启动 GridViewActivity 的 代码 如 下 : 


Button gridviewbtn- (Button) this.findViewById (R.id.button12) ; 
gridviewbtn.setOnClickListener (new OnClickListener()( 
GOverride 
public void onClick (View v) ( 
// TODO Auto-generated method stub 
Intent intent-new Intent 
(WidgetDemoActivity.this,GridViewActivity.class) ; 
startActivity (intent) ; 
1 
31.8 


同时 在 AndroidManifest.xml 文件 中 声明 该 Activity: 


<activity android:name="GridViewActivity"></activity> 


GridViewActivity 运行 效果 如 图 4.33 所 示 。 
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图 4.33 GridViewActivity 运行 效果 
GridViewActivity 使 用 的 布局 文件 为 gridview.xml， 其 内 容 如 下 : 


<?xml version="1.0" encoding="utf-8"?> 
<LinearLayout 
xmlns:android-"http://schemas.android.com/apk/res/android" 
android:layout width- "match parent" 
android:layout height-"match parent" 
android:orientation-"vertical"» 


«GridView 
android: id="@+id/gridView1" 
android:layout width-"match parent" 
android:layout height-"wrap content" 
android:numColumns-"3"» 

«/GridView» 


</LinearLayout> 


该 视图 采用 了 LinearLayout 的 布局 方式 ， 其 中 放置 了 一 个 GridView 组 件 ， 该 组 件 EH 
组 成 。 
GridViewActivity.java 代码 如 下 : 


package introduction.android.widgetDemo; 


import android.app.Activity; 
import android.content.Context; 
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import android.os.Bundle; 

import android.util .Log; 

import android.view.View; 

import android.view.ViewGroup; 

import android.widget .AdapterView; 

import android.widget .AdapterView.OnItemClickListener; 
import android.widget .BaseAdapter; 

import android.widget.GridView; 

import android.widget.ImageView; 


public class GridViewActivity extends Activity { 
public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState) ; 
setContentView (R.layout.gridview) ; 


GridView gridview- (GridView) findViewById (R.id.gridViewl) ; 
gridview.setAdapter (new ImageAdapter (this) ) ; 


gridview.setOnItemClickListener (new OnItemClickListener () { 
public void onItemClick (AdapterView<?>parent, View v, 
int position, long id) { 
Log.i ("gridview"，" 这 是 第 "+position+" 幅 图 像 。") ; 


Di; 


public class ImageAdapter extends BaseAdapter { 
private Context mContext; 


public ImageAdapter (Context c) { 
mContext=c; 


/* 获取 当前 图 片 数量 */ 
@Override 
public int getCount (){ 
return mThumbIds. length; 


/* 根据 需要 position 获得 在 GridView 中 的 对 象 */ 

GOverride 

public Object getItem (int position) { 
return position; 


/* 获得 在 GridView 中 对 象 的 ID */ 


109 


oid 4.X 从 入 门 到 精通 


GOverride 
public long getItemId (int id) ( 
return id; 
} 
GOverride 
public View getView (int position, View convertView, ViewGroup 
parent) ( 
ImageView imageView; 
if (convertView--null) ( 
/* 实例 化 ImageView 对 象 */ 
imageView-new ImageView (mContext) ; 
/* 设置 ImageView 对 象 布局 ， 设 置 View fj height 和 width 
ef 


imageView.setLayoutParams (new 
GridView.LayoutParams (85, 85) ) ; 
/* 设置 边界 对 齐 */ 
imageView.setAdjustViewBounds (false) ; 
/* 按 比例 统一 缩放 图 片 〈 保 持 图 片 的 尺寸 比例 ) */ 
imageView.setScaleType 
(ImageView.ScaleType.CENTER_CROP) ; 
/* 设置 间距 */ 
imageView.setPadding (8, 8, 8, 8); 
} else ( 
imageView= (ImageView) convertView; 
} 
imageView.setImageResource (mThumbIds [position] ) ; 
return imageView; 


// references to our images 
private Integer[] mThumbIds-( R.drawable.sample 2, 
R.drawable.sample 3, 
R.drawable.sample 4, R.drawable.sample 5, 
R.drawable.sample 6, 
R.drawable.sample 7, R.drawable.sample 0, 
R.drawable.sample 1, 
R.drawable.sample 2, R.drawable.sample 3, 
R.drawable.sample 4, 
R.drawable.sample 5, R.drawable.sample 6, 
R.drawable.sample 7, 
R.drawable.sample 0, R.drawable.sample 1, 
R.drawable.sample 2, 
R.drawable.sample 3, R.drawable.sample 4, 
R.drawable.sample 5, 
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R.drawable.sample 6, R.drawable.sample 7 }; 
y 


在 主 程序 GridViewActivity #1, Jg GridView 设置 了 一 个 数据 适配器 ， 并 处 理 了 GridView 
4 单 击 事件 。 适 配器 继承 自 BaseAdapter 类 ， 与 上 章节 中 用 到 的 适配器 高 度 相似 ， 在 此 不 再 
ES. 


Im 


book 


4.417 标签 (Tab) 


在 有 限 的 手机 屏幕 空间 内 ， 当 要 浏览 的 内 容 较 多 ， 无 法 在 一 个 屏幕 空间 内 全 部 显示 时 ， 
可 以 使 用 滚动 视图 来 延长 屏幕 的 空间 。 当 浏览 的 内 容 具 有 很 强 的 类 别 性 质 时 ， 更 合适 的 方法 
是 将 不 同类 别 的 内 容 集中 到 各 自 的 面板 中 ， 这 时 就 需要 使 用 面板 Tab 组 件 了 。 
Tab 组 件 利用 面板 标签 把 不 同 的 面板 内 容 切换 到 屏幕 上 ， 以 显示 不 同类 别 的 内 容 。 
下 面 通过 一 个 实例 来 了 解 一 下 Tab 组 件 的 使 用 方法 。 在 工程 WidgetDemo 的 布局 文件 
main.xml 中 添加 一 个 名 为 TabDemo 的 Button， 用 以 启动 TabActivity。 
在 main.xml 中 添加 代码 如 下 : 
<Button 
android: id="@+id/button13" 
android:layout width-"wrap content" 


android:layout height-"wrap content" 
android:text-"TabDemo" /» 


单 击 Button 并 启动 GridViewActivity 的 代码 如 下 : 
Button tabbtn= (Button) this.findViewById (R.id.button13) ; 
tabbtn.setOnClickListener (new OnClickListener () { 


@Override 
public void onClick (View v) { 


// TODO Auto-generated method stub 


Intent intent=new Intent 
(WidgetDemoActivity.this,TabActivity.class) ; 


startActivity (intent) ; 


} 
3: 


同时 在 AndroidManifest.xml 文件 中 声明 该 Activity: 
<activity android:name="TabActivity"></activity> 


TabActivity 运行 效果 如 图 4.34 所 示 。 
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TABI TAB2 


Tab3 页 面 


图 4.34 TabActivity 运行 效果 


要 使 用 Tab 必然 涉及 它 的 容器 TabHost，TabHost 包括 TabWigget 和 FrameLayout 两 部 
分 。TabWidget 就 是 每 个 Tab 的 标签 ，FrameLayout 是 Tab 的 内 容 。 

TabActivity 使 用 的 布局 文件 是 tab.xml。 在 tab.xml 中 定义 了 每 个 Tab 中 要 显示 的 内 容 ， 
代码 如 下 : 


<?xml version="1.0" encoding="utf-8"?> 
«TabHost xmlns:android="http://schemas.android.com/apk/res/android" 
android: id="@+id/tabhost" 
android:layout width-"fill parent" 
android:layout height-"fill parent"» 
«LinearLayout 
android:layout width-"fill parent" 
android:layout height-"fill parent" 
android:orientation-"vertical"» 
<TabWidget 
android: id="@android:id/tabs" 
android:layout width-"fill parent" 
android:layout height-"wrap content" /» 
«FrameLayout 
android: id="@android:id/tabcontent" 
android: layout_width="fill_parent" 
android: layout_height="fill_parent"> 
<TextView 
android: id="@+id/tab1" 
android: layout_width="wrap_content" 
android: layout_height="wrap_content" 
android: textSize="40dp" 
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android:text="Tabl 页 面 " /> 

<TextView 
android:id="@+id/tab2" 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:textSize-"40dp" 
android:text="Tab2 页 面 " /> 

<TextView 
android:id="@+id/tab3" 
android: layout_width="wrap_content" 
android:layout height-"wrap content" 
android:textSize-"40dp" 
android:text-"Tab3 页 面 " /> 

</FrameLayout> 
</LinearLayout> 
</TabHost> 


在 FrameLayout 中 我 们 放置 了 三 个 TextView 组 件 ， 分 别 对 应 三 个 Tab 所 显示 的 内 容 ， 当 
切换 不 同 的 Tab 时 会 自动 显示 不 同 的 TextView 内 容 。 

在 主 程序 TabActivity 的 OnCreate() 方 法 中 ， 首 先 获 得 了 TabHost 的 对 象 ， 并 调用 setupO 
方法 进行 初始 化 ， 然 后 通过 TabHost.TabSpec 增加 Tab 页 ， 通 过 setContentO 增 加 当前 Tab 页 
显示 的 内 容 ， 通 过 setIndicator 增加 页 的 标签 ， 最 后 设 定 当前 要 显示 的 Tab 页 。 

TabActivity 代码 如 下 : 


package introduction.android.widgetDemo; 


import android.app.Activity; 
import android.os.Bundle; 
import android.widget.TabHost; 


public class TabsActivity extends Activity { 
public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState) ; 
setContentView (R.layout.tab) ; 
// 步骤 1: 获得 TabHost 的 对 象 ， 并 进行 初始 化 setup () 
TabHost tabs= (TabHost) findViewById (R.id.tabhost) ; 
tabs.setup(); 
// 步骤 2; 通过 TabHost .TabSpec 增加 tab 的 一 页 ， 通 过 setContent () 增加 
内 容 ， 通 过 setIndicator 增加 页 的 标签 
/* 增加 第 1 个 Tab */ 
TabHost.TabSpec spec=tabs.newTabSpec ("Tagl") ; 
// 单 击 Tab 要 显示 的 内 容 
spec.setContent (R.id.tabl) ; 
/* 显示 Tab3 内 容 */ 
spec.setIndicator ("Tabi") ; 
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tabs.addTab (spec) ; 

/* 增加 第 2 个 Tab */ 

spec=tabs .newTabSpec ("Tag2") ; 

spec.setContent (R.id.tab2) ;// 单 击 Tab 要 显示 的 内 容 

/* 显示 Tab3 WA */ 

spec.setIndicator ("Tab2") ; 

tabs.addTab (spec) ; 

/* 增加 第 3 4 Tab */ 

spec-tabs.newTabSpec ("Tag3") ; 

spec.setContent (R.id.tab3) ;// if; Tab 要 显示 的 内 容 

/* 显示 Tab3 内 容 */ 

spec.setIndicator ("Tab3") ; 

tabs.addTab (spec) ; 

/* 步骤 3: 可 通过 setCurrentTab (index) 指定 显示 的 页 ， 从 0 开始 计算 。 
cal} 

tabs.setCurrentTab (0) ; 


j 


除了 使 用 上 述 方法 设置 Tab 页 面 的 显示 内 容 外 ， 还 可 以 使 用 setContent (Intent) 方法 启 
动 某 个 Activity， 并 将 该 Activity 的 视图 作为 Tab 页 面 的 内 容 。 
例如 : 
Intent intent=new Intent().setClass (this, AlbumsActivity.class) ; 
spec=tabHost.newTabSpec ("albums") .setIndicator ("Albums", 
res.getDrawable (R.drawable.ic_tab_albums) ) 


.setContent (intent) ; 
tabHost.addTab (spec) ; 


4.5 Menu füActionBar 


菜单 是 人 机 交互 的 重要 接口 ， 在 Android SDK 中 ， 提 供 了 菜单 类 android.view.Menu, LL 
完成 与 菜单 有 关 的 操作 。 

Android SDK 提供 三 种 菜单 ， 分 别 为 : 

® Options Menu: 又 称 选 项 菜单 ， 是 Activity 的 主要 菜单 项 的 集合 ， 当 用 户 单 击 Menu 
按钮 时 出 现 。 在 Android 2.3 以 下 的 版 本 中 ， 这 种 菜单 最 多 显示 六 个 带 图 标的 菜单 
项 。 当 菜单 中 含有 六 个 以 上 的 菜单 项 时 ， 弹 出 菜单 将 只 显示 前 五 个 菜单 ， 第 六 个 菜单 
项 会 变 为 More， 单 击 More 菜单 项 后 会 出 现 扩 展 菜单 。 扩 展 菜单 不 支持 图 标 ， 但 支持 
单 选 框 和 复 选 框 。 在 Android 3.0 (API Level 11) 及 其 以 上 版 本 中 ， 默 认 情 况 下 直接 
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弹出 的 选项 菜单 不 再 显示 图 标 。 
* Context Menu; 又 称 上 下 文 菜单 ， 是 一 个 悬浮 的 菜单 项 列表 ， 当 用 户 单 击 注册 了 上 下 
文 菜单 的 组 件 时 出 现 。 上 下 文 菜单 不 支持 菜单 图 标 和 快捷 键 。 
© Submenu 又 称 子 菜单 ， 是 菜 个 菜单 项 的 扩展 ， 是 一 个 悬浮 的 菜单 项 列表 。 子 菜单 不 
支持 菜单 图 标 或 者 谋 套 子 菜单 。 


4.5.1 Options Menu 


要 实现 选项 菜单 的 功能 ， 首 先 需 3 
onOptionsItemSelected() 方 法 对 菜单 被 单 击 事件 进行 监听 和 处 理 。 


第 4 章 MAREFA 


载 OnCreatOptionsMenu() 方 法 创建 菜单 ， 然 后 通过 


创建 一 个 名 为 MenusDemo 的 Eclipse Android Project， 在 该 工程 中 对 菜单 的 相关 知识 进行 


PSY 


Fao 


在 工程 的 res 目录 下 创建 一 个 menu 目录 ， 用 于 存放 菜单 相关 的 xml 文件 。 在 该 目录 下 创 
建 mymenu.xml， 代 码 如 下 : 


<?xml version="1.0" encoding="utf-8"?> 
«menu xmlns:android-"http://schemas.android.com/apk/res/android"» 


«item 


android: 
android: 
android: 


«item 


android: 
android: 
android: 


«item 


android: 
android: 
android: 


«item 


android: 


android 
android 
«item 


android: 
android: 
android: 


«item 


android: 
android: 
android: 


«item 


android: 
android: 


id="@+id/item1" 
title="@string/menuitem1" 
icon="@drawable/icon01"/> 


id="@+id/item2" 
title="@string/menuitem2" 
icon- "Gdrawable/icon02"/» 


id="@+id/item3" 
title="@string/menuitem3" 


icon="@drawable/icon03"/> 


id="@+id/item4" 


:title="@string/menuitem4" 
:icon-"edrawable/icon04"/» 


id="@+id/item5" 
title="@string/menuitem5" 
icon="@drawable/icon05"/> 


id="@+id/item6é" 
title="@string/menuitem6é" 
icon="@drawable/icon06"/> 


id="@+id/item7" 
title="@string/menuitem7" 
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android: icon="@drawable/icono7"/> 
</menu> 


mymenu.xml 创建 了 一 个 具有 七 个 菜单 项 的 菜单 ， 并 且 通 过 android:id 属性 为 每 个 菜单 项 
指定 了 id， 通 过 android:title 属性 为 每 个 菜单 项 指定 了 显示 的 菜单 项 内 容 ， 通 过 android:icon 


属性 指定 了 每 个 菜单 项 的 图 标 。 对 应 的 图 标 文件 放置 到 res/drawable 目录 下 。 


为 工程 MenusDemo 创建 名 为 MenusActivity 的 Activity， 将 mymenu.xml 中 定义 的 菜单 


置 为 MenusActivity 的 菜单 ， 


package introduction.android.menusDemo; 


import android.app.ActionBar; 
import android.app.Activity; 
import android.os.Bundle; 

import android.view.Menu; 

import android.view.MenuInflater; 
import android.view.MenuItem; 
import android.view.View; 

import android.widget.TextView; 


public class MenusDemoActivity extends Activity { 
private TextView textview; 
/** Called when the activity is first created. */ 
@Override 
public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState) ; 
setContentView (R.layout.main) ; 
textview- (TextView) findViewById (R.id.textviewl) ; 
} 
@Override 
public boolean onOptionsItemSelected (MenuItem item) { 
// TODO Auto-generated method stub 
switch (item.getItemId()) { 
case R.id.itemi: 
textview.setText ("iteml selected!") 
break; 
case R.id.item2: 
textview.setText ("item2 selected!") ; 
break; 
case R.id.item3: 
textview.setText ("item3 selected!") ; 
break; 
default: 
break; 
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return super.onOptionsItemSelected (item) ; 
} 
@Override 
public boolean onCreateOptionsMenu (Menu menu) { 
MenuInflater inflater-getMenuInflater(); 
inflater.inflate (R.menu.mymenu, menu) ; 
return true; 


} 


其 中 ， 


public boolean onCreateOptionsMenu (Menu menu) { 
MenuInflater inflater=getMenuInflater () ; 
inflater.inflate (R.menu.mymenu, menu) ; 
return true; 
} 


这 几 行 代码 通过 Menulnflater. Inflate() 方 法 将 menu.xml 中 的 定义 的 菜单 项 内 容 填 充 到 了 
菜单 中 。 

在 OnCreatOptionsMenu() 方 法 中 创建 菜单 时 也 支持 Menu.add0 方 法 ， 也 能 达到 同样 目 
的 。 例 如 : 


menu.add (0,itemid,0,item_title) ; 
表示 在 菜单 中 添加 一 个 菜单 项 ， 该 菜单 项 的 id 为 itemid， 菜 单项 显示 的 内 容 为 item title 


的 内 容 。 但 是 不 鼓励 使 用 这 种 方式 ， 而 应 该 使 用 xml 文件 来 创建 菜单 。 
运行 MenusDemo 实例 ， 单 击 手 机 的 Menu 按钮 ， 得 到 运行 效果 如 图 4.35 所 示 。 


n MenusDemo 


menuitem1 


menuitem2 


menuitem3 


menuitem4 


menuitem5 


menuitem6 


menuitem7 


F435 “Menu” 按 钮 运行 效果 
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由 运行 效果 可 见 ，MenusActivity 已 经 根据 mymenu.xml 文件 创建 了 一 个 具有 七 个 菜单 项 
的 菜单 。 但 是 虽然 在 mymenuxml 文件 中 为 每 个 菜单 项 指定 了 一 个 图 标 ， 但 是 生成 的 选项 菜 
单 中 却 并 没有 图 标 被 显示 出 来 ， 这 是 为 什么 呢 ? 

实例 MenusDemo 当前 的 运行 环境 是 Android4.0， 其 API Level 为 14。 我 们 先 看 一 下 ， 同 
样 的 代码 ， 在 API Level 11 之 前 的 运行 效果 。 

双击 打开 AndroidManifest.xml 文件 ， 将 其 中 的 代码 : 


<uses-sdk android:minSdkVersion="14" /> 

BON: 

<uses-sdk android:minSdkVersion="9" /> 

再 次 运行 MenusDemo 实例 ， 单 击 Menu 按钮 ， 得 到 运行 效果 如 图 4.36 所 示 。 

可 见 运 行 在 早期 的 API 之 上 的 选项 菜单 效果 要 更 好 一 些 。 为 什么 会 出 现 这 种 现象 呢 ? 其 


实在 Android SDK 3.0 之 后 ， 就 不 再 鼓励 直接 使 用 选项 菜单 ， 而 是 将 选项 菜单 和 ActionBar 结 
合 使 用 。 


© 


menuitem1 menuitem2 menuitem3 


menuitem4 menuitem5 


图 4.36 API Level 11 之 前 Menu 按钮 运行 效果 


ActionBar 又 称 活动 栏 ， 位 于 Activity 的 顶部 ， 取 代 了 原来 的 标题 的 位 置 。ActionBar 中 包 
含 很 多 ActionItem， 相 当 于 选项 菜单 的 菜单 项 。 将 选项 菜单 与 ActionBar 结合 的 方法 很 简单 ， 
只 要 在 xml 文件 中 添加 一 个 android:showAsAction="ifRoom" 属 性 即 可 。 该 属性 表现 如 果 标 题 
栏 有 空间 的 话 ， 就 将 相关 的 菜单 项 放置 到 ActionBar 中 。 如 果 标 题 栏 空间 不 足 ， 未 能 放置 到 
其 中 的 菜单 项 仍然 会 以 选项 菜单 的 形式 出 现 。 
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P MenusDemo 


menuitem3 


menuitem4 


menuitem5 


menuitem6 


menuitem7 


图 4.37 ActionBar 运行 效 果 


4.5.2 Context Menu 

上 下 文 菜单 注册 到 View 对 象 上 后 ， 用 户 长 按 该 View 对 象 可 呼出 上 下 文 菜单 。 上 下 文 菜 
单 悬 浮 于 主 界面 之 上 ， 不 支持 图 标 显示 和 快捷 键 。 其 使 用 方法 和 选项 菜单 高 度 相 似 ， 只 不 过 
创建 上 下 文 菜单 的 方法 为 onCreateContextMenu(), ， 响 应 上 下 文 菜单 单 击 事件 的 方法 为 
onContextItemSelected().. 

仍 以 工程 MenusDemo 为 例 ， 为 MenusActivity 的 视图 中 的 TextView 对 象 添加 一 个 具有 两 
个 菜单 项 的 上 下 文 菜单 ， 运 行 效果 如 图 4.38 所 示 。 
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上 下 文 菜单 项 一 


上 下 文 菜单 项 二 


图 4.38 两 个 上 下 文 菜单 的 运行 结果 
为 TextView 对 象 注册 上 下 文 菜单 的 代码 如 下 : 


textview= (TextView) findViewById (R.id.textviewl) ; 
registerForContextMenu (textview) ; 


创建 并 处 理 上 下 文 菜单 单 击 事件 的 代码 如 下 : 


public boolean onContextItemSelected (MenuItem item) { 
// TODO Auto-generated method stub 


switch (item.getItemId()) { 
case R.id.item6: 
Log.i ("menu", "item6!") ; 
break; 
case R.id.item7: 
Log.i ("menu","item7!") ; 
break; 
default: 
break; 
} 
return super.onContextItemSelected (item) ; 
} 
@Override 
public void onCreateContextMenu (ContextMenu menu, View v, 
ContextMenuInfo menuInfo) { 
// TODO Auto-generated method stub 
menu.add (0, R.id.item6, 0, "LF FXGEGJ—") 
menu.add (0, R.id.item7, 0, "上 下 文 菜单 项 二 ") 
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super.onCreateContextMenu (menu, v, menuInfo) ; 


4.5.3 SubMenu 


子 菜单 可 以 被 添加 到 其 他 菜单 上 ， 但 是 子 菜单 本 身 不 能 再 有 子 菜单 。 使 用 addSubMenuO 
方法 为 MenusActivity 的 选项 菜单 添加 一 个 子 菜单 ， 运 行 效果 如 图 4.39 所 示 。 


图 4.39 ”添加 子 菜单 的 运行 效果 


实现 该 子 菜单 需要 


i 号 onCreateOptionsMenu() 方 法 ， 代 码 如 下 : 


public boolean onCreateOptionsMenu (Menu menu) { 
MenuInflater inflater=getMenuInflater () ; 
inflater.inflate (R.menu.mymenu, menu) ; 
SubMenu submenu=menu.addSubMenu (" 子 菜单 ") ; 
submenu.add (0,1,0," 子 菜单 项 一 ") ; 
submenu.add (0，2，0，" 子 菜单 项 二 ") ; 
return true; 

H 


子 菜单 的 事件 处 理 代码 在 onOptionsItemSelected0 中 实现 。 
MenusActivity.java 完整 代码 如 下 : 


package introduction.android.menusDemo; 


import android.app.ActionBar; 
import android.app.Activity; 
import android.os.Bundle; 
import android.util.Log; 
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import android.view.ContextMenu; 

import android.view.ContextMenu.ContextMenuInfo; 
import android.view.Menu; 

import android.view.MenuInflater; 

import android.view.MenuItem; 

import android.view.SubMenu; 

import android.view.View; 

import android.widget.TextView; 


public class MenusDemoActivity extends Activity { 
private TextView textview; 
/** Called when the activity is first created. */ 
@Override 
public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState) ; 
setContentView (R.layout.main) ; 
textview- (TextView) findViewById (R.id.textviewl) ; 
registerForContextMenu (textview) ; 
Jil setContentView (textview) ; 
} 
@Override 
public boolean onOptionsItemSelected (MenuItem item) { 
// TODO Auto-generated method stub 
switch (item.getItemId()) { 
case 1: 
Log.i ("menu", "Submenu item 1 selected") ; 
case R.id.itemi: 
textview.setText ("iteml selected!") 
break; 
case R.id.item2: 
textview.setText ("item2 selected!") 
break; 
case R.id.item3: 
textview.setText ("item3 selected!") 


break; 
default: 
Log.i ("menu","other items selected") ; 
break; 
} 
return super.onOptionsItemSelected (item) ; 
} 
GOverride 


public boolean onCreateOptionsMenu (Menu menu) ( 
MenuInflater inflater-getMenuInflater(); 
inflater.inflate (R.menu.mymenu, menu) ; 
SubMenu submenu-menu.addSubMenu ( " 子 菜单 ") ; 
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submenu.setIcon (android.R.drawable.ic_menu_crop) ; 
submenu.add (0,1,0," 子 菜单 项 一 ") ; 
submenu.add (0，2，0，" 子 菜单 项 二 ") ; 
return true; 
} 
@Override 
public boolean onContextItemSelected (MenuItem item) { 
// TODO Auto-generated method stub 


switch (item.getItemId()) { 
case R.id.item6: 
Log.i ("menu","item6!") ; 
break; 
case R.id.item7: 
Log.i ("menu","item7!") ; 
break; 
default: 
break; 
} 
return super.onContextItemSelected (item) ; 
} 
GOverride 
public void onCreateContextMenu (ContextMenu menu, View v, 
ContextMenuInfo menuInfo) ( 
// TODO Auto-generated method stub 
menu.add (0, R.id.item6, 0, "上下文 菜单 项 一 ") ; 
menu.add (0, R.id.item7, 0, "I FOE —") ; 
super.onCreateContextMenu (menu, v, menuInfo) ; 


Bitmap 


通过 不 同 的 排列 和 染色 以 构成 图 样 。Bitmap 是 Android 系统 中 图 像 处 理 最 重要 的 类 之 一 ， 用 
它 可 以 获取 图 像 文 件 信息 ， 对 图 像 进 行 剪 切 、 旋 转 、 缩 放 等 操作 ， 并 可 以 将 图 像 保 存 成 特定 
格式 的 文件 。Bitmap 位 于 android.graphics 包 中 ，Bitmap 不 提供 对 外 的 构造 方法 ， 只 能 通过 
BitmapFactory 类 进行 实例 化 。 利 用 BitmapFactory 的 decodeFile 方法 可 以 从 特定 文件 中 获取 
Bitmap 对 象 ， 也 可 以 使 用 decodeResource() 从 特定 的 图 片 资 源 中 获取 Bitmap 对 象 。 

实例 BitmapDemo 从 资源 文件 中 创建 Bitmap 对 象 ， 并 对 其 进行 一 些 操作 ， 运 行 效果 如 图 
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4.40 所 示 。 


P BitmapDemo 


图 4.40 Bitmap 对 象 的 效果 
其 对 应 布局 文件 Main.xml 内 容 如 下 : 


<?xml version="1.0" encoding="utf-8"?> 
<LinearLayout 
xmlns:android-"http://schemas.android.com/apk/res/android" 
android:layout width-"fill parent" 
android:layout height-"fill parent" 
android:orientation-"vertical"» 
<SeekBar 
android: id="@+id/seekBarId" 
android: layout_width="fill_ parent" 
android:layout height-"wrap content" /> 


«ImageView 

android: id="@+id/imageview" 
android: layout_width="wrap content" 
android: layout_height="wrap_content" 
android:src="@drawable/im01" /> 

</LinearLayout> 

BitmapDemoActivity.Java 代码 如 下 : 

package introduction.android.bitmapDemo; 


import com.sie.bitmapdemo.R; 
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import android.app.Activity; 

import android.graphics.Bitmap; 

import android.graphics.BitmapFactory; 

import android.graphics.Matrix; 

import android.os.Bundle; 

import android.widget.ImageView; 

import android.widget.SeekBar; 

import android.widget.SeekBar.OnSeekBarChangeListener; 
import android.widget.TextView; 


public class BitmapDemoActivity extends Activity 
{ 

ImageView myImageView; 

Bitmap myBmp, newBmp; 

int bmpWidth, bmpHeight; 

SeekBar seekbarRotate; 

float rotAngle; 


@Override 
public void onCreate (Bundle savedInstanceState) 
{ 
super.onCreate (savedInstanceState) ; 
setContentView (R.layout.main) ; 
myImageView- (ImageView) findViewById (R.id.imageview) ; 
// H Resource 载 入 图 片 
myBmp=BitmapFactory.decodeResource (getResources(), 
R.drawable.im01) ; 
bmpWidth=myBmp.getWidth () ; 
bmpHeight=myBmp.getHeight () ; 
// 实例 化 matrix 
Matrix matrix=new Matrix(); 
// 设 定 Matrix 属性 x, y 缩放 比例 为 1.5 
matrix.postScale (1.5F, 1.5F) ; 
// 顺 时 针 旋转 45 度 
matrix.postRotate (45.0F) ; 
newBmp=Bitmap.createBitmap (myBmp, 0, 0, bmpWidth, bmpHeight, 
matrix, true) ; 
seekbarRotate= (SeekBar) findViewById (R.id.seekBarId) ; 
SeekbarRotate.setOnSeekBarChangeListener (onRotate) ; 
y 
private SeekBar.OnSeekBarChangeListener onRotate-new 
SeekBar .OnSeekBarChangeListener () { 


public void onStopTrackingTouch (SeekBar seekBar) 


{ 
// TODO Auto-generated method stub 
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D 


public void onStartTrackingTouch (SeekBar seekBar) 


t 
// TODO Auto-generated method stub 


} 


public void onProgressChanged (SeekBar seekBar, int progress, 
boolean fromUser) 


{ 
// TODO Auto-generated method stub 


Matrix m=new Matrix(); 

m.postRotate ( (float) progress*3.6F) ; 

newBmp=Bitmap.createBitmap (myBmp, 0, 0, bmpWidth, 
bmpHeight, m, true) ; 

myImageView.setImageBitmap (newBmp) ; 


) 
1m 
} 


本 实例 实现 了 拖 动 进度 条 图 片 旋转 的 效果 。 使 用 BitmapFactory 从 资源 中 载 入 图 片 ， 并 获 
取 图 片 的 宽 和 高 ， 之 后 使 用 Matrix 类 对 图 片 进行 缩放 和 旋转 操作 。 


4 / 对 话 框 〈Dialog ) 


对 话 框 是 人 机 交互 过 程 中 十 分 常见 的 组 件 ， 一 般 用 于 在 特定 条 件 下 对 用 户 显 示 一 些 信 
息 ， 可 以 增强 应 用 的 友好 性 。 

Dialog 类 是 对 话 框 的 基 类 。 对 话 框 虽然 可 以 在 界面 上 显示 ， 但 是 Dialog 不 是 View 类 的 
子 类 ， 而 是 直接 继承 自 java.lang.Object 类 。Dialog 对 象 也 有 自己 的 生命 周期 ， 其 生命 周期 由 
创建 它 的 Activity 进行 管理 。Activity 可 以 调用 showDialog (int id) 将 不 同 id 的 对 话 框 显示 
出 来 ， 也 可 以 调用 dismissDialog Cint id) 方法 将 id 标识 的 对 话 框 从 用 户 界 面 中 关闭 掉 。 当 
Activity 调用 了 showDialog (id) 方法 ， 对 应 id 的 对 话 框 没有 被 创建 ，Android 系统 会 回调 
OnCreateDialog (id) 方法 来 创建 具有 该 id 的 对 话 框 。 在 Activity 中 创建 的 对 话 框 都 会 被 
Activity 保存 ， 下 次 showDialog (id) 方法 被 调用 时 ， 若 该 id 对 话 框 已 经 不 创建 ， 则 系统 不 
会 再 次 调用 OnCreateDialog (id) 方法 创建 该 对 话 框 ， 而 是 会 回调 onPrepareDialog (int id, 
Dialog dialog) 方法 ， 该 方法 允许 对 话 框 在 被 显示 之 前 做 一 些 修 改 。 

常用 的 对 话 框 有 AlertDialog 和 ProgressDialog， 本 节 将 通过 实例 讲解 这 两 种 对 话 框 的 使 
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用 方法 。 


4.7.1 AlertDialog 

AlertDialog 对 话 框 是 十 分 常用 的 用 于 显示 信息 的 方式 ， 最 多 可 提供 三 个 按钮 。 
AlertDialog 不 能 直接 通过 构造 方法 构建 ， 而 要 由 AlertDialog.Builder 类 来 创建 。AlertDialog 对 
话 框 的 标题 、 按 钮 以 及 按钮 要 响应 的 事件 也 由 AlertDialog.Builder 设置 。 

在 使 用 AlertDialog. Builder 创建 对 话 框 时 常用 的 几 个 方法 如 下 : 


setTitle0: 设置 对 话 框 设置 标题 。 

setIcon(): 设置 对 话 框 设置 图 标 。 

setMessage(): 设置 对 话 框 的 提示 信息 。 
setPositiveButton(): 对 话 框 添加 yes 按钮 。 
setNegativeButton(): 对 话 框 添加 no 按钮。 
setNeutralButton(): 为 对 话 框 添加 第 三 个 按钮 。 


e © o o òo o 


下 面 通过 实例 来 学 习 创建 AlertDialog 的 方法 。 

创建 Eclipse Android 工程 DialogDemo， 并 在 main.xml 中 添加 两 个 按钮 ， 分 别 为 
AlertDialog 和 ProcessDialog。 

其 main.xml 代码 如 下 : 


<?xml version-"1.0" encoding-"utf-8"?» 
«LinearLayout 
xmlns:android-"http://schemas.android.com/apk/res/android" 
android:layout width-"fill parent" 
android:layout height-"fill parent" 
android:orientation-"vertical"» 


«TextView 
android:layout width-"fill parent" 
android:layout height-"wrap content" 
android:text-"Dialog oz" /> 


«Button 
android: id="@+id/button1" 
android: layout_width="match_parent" 
android:layout height-"wrap content" 
android:text-"AlertDialog" /» 


«Button 
android: id="@+id/button2" 
android: layout_width="match_ parent" 
android: layout_height="wrap_ content" 
android: text="ProgressDialog" /> 
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</LinearLayout> 


其 运行 效果 如 图 4.41 所 示 。 


AlertDialog 


ProgressDialog 


441 AlertDialog 的 运行 效果 
处 理 AlertDialog 按钮 单 击 事件 的 代码 为 : 


btn- (Button) findViewById (R.id.buttonl) ; 
btn.setOnClickListener (new OnClickListener()( 
@Override 
public void onClick (View v) { 
// TODO Auto-generated method stub 
showDialog (ALERT DLG) ; 


TON 


"ick AlertDialog 按钮 ， 调 用 showDialog (ALERT_DLG) ， 系 统 回调 onCreateDialog 
(Cint id) 方法 ， 创 建 并 弹出 AlertDialog 对 话 框 ， 如 图 4.42 所 示 。 


[i] AlertDialog 


这 是 一 个 AlertDialog 


Negative Neutral Positive 


图 4.42 单 击 AlertDialog 按 钮 的 效果 
相关 代码 为 : 
protected Dialog onCreateDialog (int id) { 
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// TODO Auto-generated method stub 
Dialog dialog-null; 
switch (id) { 
case ALERT DLG: 
AlertDialog.Builder builder-new AlertDialog.Builder 
(DialogDemoActivity.this) ; 
builder.setIcon (android.R.drawable.ic dialog info) ; 
builder.setTitle ("AlertDialog") ; 
builder.setMessage ("这 是 一 个 AlertDialog") ; 
builder.setPositiveButton ("Positive",new 
DialogInterface.OnClickListener()( 


@Override 
public void onClick (DialogInterface dialog, int 
which) { 
// TODO Auto-generated method stub 
Log.i ("DialogDemo", "OK 按钮 被 单 击 ! ") ; 


D: 
builder.setNegativeButton ("Negative",new 


DialogInterface.OnClickListener () { 


GOverride 
public void onClick (DialogInterface dialog, int 
which) ( 
// TODO Auto-generated method stub 
Log.i ("DialogDemo", "Cancel 按钮 被 单 击 ! ") ; 


}) ; 
builder.setNeutralButton ("Neutral",new 


DialogInterface.OnClickListener () { 


@Override 
public void onClick (DialogInterface dialog, int 
which) { 
// TODO Auto-generated method stub 
Log.i ("DialogDemo", "Neutral 按钮 被 单 击 ! ") ; 


Di; 
dialog=builder.create(); 
break; 

default: 
break; 
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} 


return dialog; 


H 


onCreateDialog() 方 法 中 创建 了 带 有 三 个 按钮 的 AlertDialog， 并 且 为 每 个 按钮 添加 了 事件 
处 理 方法 ， 以 便 获 知 用 户 单 击 了 哪个 按钮 。 


4.7.2 ProgressDialog 

ProgressDialog 是 一 个 带 有 进度 条 的 对 话 框 ， 当 应 用 程序 在 完成 比较 耗 时 的 工作 时 ， 使 用 
该 对 话 框 可 以 为 用 户 提供 一 个 总 进度 上 的 提示 。 

为 main.xml 布局 中 的 ProgressDialog 按钮 添加 事件 处 理 代码 : 


progressbtn= (Button) findViewById (R.id.button2) ; 
progressbtn.setOnClickListener (new OnClickListener()( 


@Override 

public void onClick (View v) { 
// TODO Auto-generated method stub 
showDialog (PROGRESS DLG) ; 


): 


单 击 ProgressDialog 按钮 ， 调 用 showDialog(PROGRESS_DLG)， 系 统 回 调 onCreateDialog(int 
id) 方 法 ， 创 建 并 弹出 ProgressDialog 对 话 框 ， 如 图 4.43 所 示 。 


18% 18/100 


图 4.43 it; ProgressDialog 按钮 的 效果 


onCreateDialog() 方 法 中 的 相关 代码 如 下 : 


case PROGRESS_DLG: 

progressDialog=new ProgressDialog (this) ; 
// 设 置 水 平 进度 条 
progressDialog.setProgressStyle 

(progressDialog.STYLE_HORIZONTAL) ; 
// 设 置 进度 条 最 大 值 为 100 
progressDialog.setMax (100) ; 
// 设 置 进度 条 当前 值 为 0 
progressDialog.setProgress (0) ; 
dialog=progressDialog; 
new Thread (new Runnable() { 
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int count=0; 
@Override 
public void run()( 
// TODO Auto-generated method stub 
while (progressDialog.getProgress()<100) { 
count+=3; 
progressDialog.setProgress (count) ; 
try { 
Thread.sleep (1000) ; 
} catch (InterruptedException e) { 
// TODO Auto-generated catch 


block 


e.printStackTrace(); 
} 


}) .start(); 
break; 


Toast 和 Notification 


Toast 和 Notification 是 Android 系统 为 用 户 提供 的 轻 量 级 的 信息 提醒 机 制 。 这 种 方式 不 会 
打上 断 用 户 当前 的 操作 ， 也 不 会 获取 到 焦点 ， 非 常 的 方便 。 
本 节 我 们 通过 实例 学 习 Toast 和 Notification 的 使 用 方法 。 


4.8.1 Toast 
创建 工程 NotificationDemo， 并 实现 如 图 4.44 布局 。 
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n NotificationDemo 


Toast 和 Notification 演 示 


Toast 


Notification 


CancelNotification 


444 工程 布局 
main.xml 代码 如 下 : 


<?xml version="1.0" encoding="utf-8"?> 
<LinearLayout 
xmlns:android-"http://schemas.android.com/apk/res/android" 
android:layout width-"fill parent" 
android:layout height-"fill parent" 
android:orientation-"vertical"» 


«TextView 
android:layout width-"fill parent" 
android:layout height-"wrap content" 
android:text-"Toast f/Notification jg" /> 


«Button 
android: id="@+id/button1" 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:text-"Toast" /» 


«Button 
android: id="@+id/button2" 
android: layout_width="wrap_ content" 
android: layout_height="wrap_content" 
android: text="Notification" /> 


<Button 
android: id="@+id/button3" 
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android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:text-"CancelNotification" /» 


</LinearLayout> 


在 NotificationDemoActivity 中 为 每 个 按钮 添加 事件 响应 。 单 击 Toast 按钮 ， 运 行 效果 如 
图 4.45 所 示 。 


P NotificationDemo 


Toast 和 Notification 演 示 


Toast 


Notification 


CancelNotification 


这 是 一 个 Toast 汗 示 ! 


图 4.45 单 击 Toast 按钮 的 效果 


相关 代码 如 下 : 


Button toastBtn- (Button) this.findViewById (R.id.buttonl) ; 
toastBtn.setOnClickListener (new View.OnClickListener () { 


@Override 
public void onClick (View v) { 


// TODO Auto-generated method stub 
Toast .makeText (NotificationDemoActivity.this, "这 


是 一 个 Toast 演示 ! ", Toast.LENGTH LONG) .show(); 


} 
19107 


Toast 用 于 向 用 户 显示 小 信息 量 的 提示 ， 它 不 会 中 断 应 用 程序 进程 ， 不 会 对 用 户 操作 造成 
任何 干扰 ， 也 不 能 与 用 户 交 互 ， 在 信息 显示 后 会 自动 消失 。 此 处 使 用 ToastmakeText 
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(Context context, CharSequence text, int duration) 方法 来 创建 一 个 Toast。 其 中 context 指 显 示 
Toast 的 上 下 文 ，text 指 Toast 中 显示 的 文字 内 容 ，duration 指 Toast 显示 延续 的 时 间 ， 该 时 间 
可 以 直接 指定 ， 也 可 以 使 用 Toast 提供 LENGTH LONG 和 LENGTH SHORT 常量 。 
Toast.show0 方 法 可 以 将 Toast 对 象 显示 出 来 。Toast 默认 情况 下 显示 在 屏幕 的 下 方 ， 可 以 通过 
Toast.setGravity() 方 法 设置 Toast 的 显示 位 置 。 例 如 ， 如 下 代码 : 


Toast toast=Toast.makeText (NotificationDemoActivity.this, 
"这 是 一 个 位 于 中 间 位 置 的 Toast"， 
Toast.LENGTH LONG) ; 
toast.setGravity (Gravity.CENTER, 0, 0); 
toast.show(); 


显示 效果 如 图 4.46 所 示 。 


BBB NotificationDemo 


Toast 和 Notification 演 示 


Toast 


Notification 


CancelNotification 


这 是 一 个 位 于 中 间 位 置 的 Toast 


图 4.46 显示 效果 


4.8.2 Notification 

Notification 可 以 在 手机 屏幕 项 部 的 状态 栏 显示 一 个 带 图 标的 通知 ， 同 时 播放 声音 或 者 使 
手机 震动 。Notification 可 以 扩展 以 显示 详细 信息 ， 单 击 该 Notification 还 可 以 跳 转 到 特定 的 
Activity。 

单 击 Notification 按钮 ， 运 行 效 果 如 图 4.47 所 示 ， 在 视图 的 状态 栏 出 现 Notification 提 
示 。 按 住 Notification 并 下 拉 ， 可 将 Notification 内 容 进行 扩展 ， 效 果 如 图 4.48 所 示 。 单 击 图 
标 处 ， 应 用 程序 跳 转 到 NoteActivity 视图 ， 运 行 效果 如 图 4.49 所 示 。 单 击 “ 返 回 ” 按 钮 ， 返 
回 到 NotificationDemoActivity 视图 。 
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© 这 是 一 个 Notification ! 


n NotificationDemo 


Toast 和 Notification 演 示 


My notification 
点 击 这 个 notification， 可 以 跳 转 到 Note 


Toast 


Notification 


CancelNotification 


Android 


图 4.47 单 击 Notification 按钮 的 效果 448 下拉 Notification 的 效果 


r NotificationDemo 


NoteActivity 


返回 


图 4.49 单 击 图 标的 效果 
相关 代码 如 下 : 


Button notifyBtn- (Button) this.findViewById (R.id.button2) ; 
notifyBtn.setOnClickListener (new View.OnClickListener () { 


@Override 
public void onClick (View v) { 
// TODO Auto-generated method stub 
context=getApplicationContext () ; 
String ns-Context.NOTIFICATION SERVICE; 
mNotificationManager- (NotificationManager) 
getSystemService (ns) ; 
int icon-R.drawable.icon01; 
CharSequence tickerText-"jxX4t— 4 Notification! "; 
long when-System.currentTimeMillis(); 
Notification.Builder builder-new Notification.Builder 
(context) ; 
builder.setSmallIcon (icon) ; 
builder.setTicker (tickerText) ; 
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builder.setWhen (when) ; 
notification=builder.getNotification(); 


CharSequence contentTitle="My notification"; 

CharSequence contentText=" 单 击 这 个 notification， 可 以 跳 转 到 
NoteActivity."; 

Intent notificationIntent=new Intent (context, 
NoteActivity.class) ; 

PendingIntent contentIntent-PendingIntent.getActivity 
(context, 0, notificationIntent, 0) ; 

notification.setLatestEventInfo (context, contentTitle, 
contentText, contentIntent) ; 

notification.defaults-notification.DEFAULT SOUND; 

mNotificationManager.notify (NOTIFICATION ID, 
notification) ; 

5 
DE: 


Notification.Builder 是 Android API Level 11 以 上 版 本 提供 的 Notification 的 创建 类 ， 可 以 
方便 地 创建 Notification 并 设置 各 种 属性 。 此 处 创建 了 一 个 Notification， 并 指定 了 显示 内 容 和 
图 标 。Notification.setLatestEventImfo() 方 法 设 定 了 当 用 户 扩展 Notification 时 显示 的 样式 ， 并 
通过 PendingIntent 对 象 指定 了 当 用 户 单 击 扩展 的 Notification 时 应 用 程序 如 何 跳 转 ， 此 处 跳 转 
至 NoteActivity。NotificationManagernotify (int id, Notification notification) 方法 为 Notification 
对 象 指定 一 个 id 值 ， 并 将 该 Notification 对 象 显示 到 状态 栏 上 。NotificationManager.cancel 

(Cint id) 方法 会 将 id 指向 的 Notification 对 象 取消 掉 。 

NoteActivity.java 代码 如 下 : 


package introduction.android.notificationDemo; 


import android.app.Activity; 
import android.content.Intent; 
import android.os.Bundle; 
import android.view.View; 
import android.widget.Button; 


public class NoteActivity extends Activity { 
private Button btn; 


public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState) ; 
setContentView (R.layout.other) ; 
btn- (Button) this.findViewById (R.id.button1) ; 
btn.setOnClickListener (new View.OnClickListener()í 
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@Override 


public void onClick (View v) { 
// TODO Auto-generated method stub 


Intent intent=new Intent 
(NoteActivity.this,NotificationDemoActivity.class) ; 


startActivity (intent) ; 
Di 
} 


NoteActivity 所 使 用 的 布局 文件 otherxml 代码 如 下 : 


<?xml version-"1.0" encoding-"utf-8"?» 
«LinearLayout 
xmlns:android-"http://schemas.android.com/apk/res/android" 
android:layout width- "match parent" 
android:layout height-"match parent" 
android:orientation-"vertical"» 


«TextView 
android: id="@+id/textView1" 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:text-"NoteActivity" /> 


«Button 
android: id="@+id/button1" 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:text-"jk/gf" /> 


</LinearLayout> 


界面 事件 响应 


事件 是 Android 平台 与 用 户 交互 的 手段 。 当 用 户 对 手机 进行 操作 时 ， 会 产生 各 种 各 样 的 
输入 事件 ，Android 框架 捕获 到 这 些 事件 ， 进 而 进行 处 理 。Android 平台 提供 了 多 种 用 于 获取 
用 户 输入 事件 的 方式 ， 考 虑 到 用 户 事件 都 是 在 特定 的 用 户 界面 中 产生 ， 因 此 Android 选用 使 
用 特定 View 组 件 来 获取 用 户 输入 事件 的 方式 ， 由 View 组 件 提供 事件 处 理 的 方法 。 这 就 是 为 
什么 View 类 内 部 带 有 处 理 特定 事件 的 监听 器 。 
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4.9.1 ”事件 监听 器 


监听 器 用 于 对 特定 事件 进行 监听 ， 一 旦 监听 到 特定 事件 ， 则 由 监听 器 截获 该 事件 ， 并 回 
调 自身 的 特定 方法 对 事件 进行 处 理 。 在 本 章 之 前 的 实例 中 ， 我 们 使 用 的 事件 处 理 方式 都 是 监 
听 器 。 根 据 用 户 输入 方式 的 不 同 ，View 组 件 将 截获 的 事件 分 为 六 种 ， 对 应 以 下 六 种 事件 监听 
器 接口 : 

(1) OnClickListener 接口 : 此 接口 处 理 的 是 单 击 事件 ， 例 如 ， 在 View 上 进行 单 击 动作 、 
在 View 获得 焦点 的 情况 下 单 击 “ 确 定 ” 按 钮 或 者 单 击 轨迹 球 都 会 触发 该 事件 。 当 单 击 事件 
发 生 时 ，OnClickListener 接口 会 回调 public void onClick (View v) 方法 对 事件 进行 处 理 。 其 
中 参数 v 指 的 是 发 生 单 击 事件 的 View 组 件 。 

(2) OnLongClickListener 接口 : 此 接口 处 理 的 是 长 按 事件 ， 当 长 时 间 按 住 某 个 View 组 
件 时 触发 该 事件 。 其 对 应 的 回调 方法 为 publie boolean onLongClick (View v) ， 当 返回 值 true 
时 ， 表 示 已 经 处 理 完 此 事件 ， 若 事件 未 处 理 完 ， 则 返回 false， 该 事件 还 可 以 继续 被 其 他 监听 
器 捕获 并 处 理 。 

(3) OnFocusChangeListener 接口 : 此 接口 用 于 处 理 View 组 件 焦点 改变 事件 。 当 View 组 
件 失去 或 获得 焦点 时 会 触发 该 事件 ， 其 对 应 的 回调 方法 为 publie void onFocusChange (View v. 
Boolean hasFocus) ， 其 中 参数 v 表示 产生 事件 的 事件 源 ，hasFocus 表示 事件 源 的 状态 ， 即 是 

(4) OnKeyListener 接口 : 此 接口 用 于 对 手机 键盘 事件 进行 监听 ， 当 View 获得 焦点 并 且 
键盘 被 敲 击 时 会 触发 该 事件 。 其 对 应 的 回调 方法 为 public boolean onKey (View v, int keyCode, 
KeyEvent event) ， 其 中 参数 keyCode 为 键盘 码 ， 参 数 event 便 为 键盘 事件 封装 类 的 对 象 。 

(5) OnTouchListener 接口 : 此 接口 是 用 来 处 理 手机 屏幕 事件 ， 当 在 View 的 范围 内 触 
摸 、 按 下 、 抬 起 、 滑 动 等 动作 时 都 会 触发 该 事件 ， 并 触发 该 接口 中 的 回调 方法 ， 其 对 应 的 
调 方 法 : public boolean onTouch (View v, MotionEvent event) 对 应 的 参数 同上 。 

(6) OnCreateContextMenuListener 接口 : 此 接口 用 于 处 理 上 下 文 菜单 被 创建 的 事件 ， 其 
对 应 的 回调 方法 为 public void onCreateContextMenu (ContextMenu menu, View v, ContextMenuInfo 
info) ， 其 中 参数 menu 为 事件 的 上 下 文 菜单 ， 参 数 info 是 该 对 象 中 封装 了 有 关上 下 文 菜单 
其 他 的 信息 。 在 4.5 节 的 实例 MenusDemo 中 ,创建 上 下 文 菜单 使 用 的 是 registerForContextMenu 
(Viewv) 方法 ， 其 本 质 是 为 View 组 件 v 注 册 该 接口 ， 并 实现 了 相应 的 回调 方法 。 


Iz] 
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在 Android 框架 中 ， 除 了 可 以 使 用 监听 器 进行 事件 处 理 之 外 ， 还 可 以 通过 回调 机 制 进行 
事件 处 理 。Android SDK 为 View 组 件 提供 了 五 个 默认 的 回调 方法 ， 如 果 当 某 个 事件 没有 被 任 
意 一 个 View 处 理 ， 则 会 在 Activity 中 调用 响应 的 回调 方法 ， 这 些 方法 分 别 如 下 所 示 。 

(1) public boolean onKeyDown (int keyCode, KeyEvent event) 方法 是 接口 KeyEvent. 
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参数 keyCode 即 键盘 码 ， 系 统 根 


据 键盘 码 得 知 按 下 的 是 哪个 按钮 。 参 数 event 为 按钮 事件 的 对 象 ， 包 含 了 触发 事件 的 详细 信 


息 ， 例 如 事件 的 类 型 、 状 态 等 。 当 此 方法 的 返回 值 为 True 时 ， 代 表 已 完成 处 理 此 事件 ， 返 回 


false 表示 该 事件 还 可 以 被 其 他 监听 器 处 理 。 


(2) public boolean onKeyUp (int keyCode, KeyEvent event) 方法 也 是 接口 KeyEvent. 
Callback 中 的 抽象 方法 ， 当 按钮 向 上 弹 起 时 被 调用 ， 参 数 与 onKeyDown(O 完 全 相同 。 

(3) public boolean onTouchEvent (MotionEvent event) 方法 在 View 中 定义 ， 当 用 户 触摸 
屏幕 时 被 自动 调用 。 参 数 event 为 触摸 事件 封装 类 的 对 象 ， 封 装 了 该 事件 的 相关 信息 。 当 用 
户 触摸 到 屏幕 ， 屏 幕 被 按 下 时 ，MotionEventgetAction0 的 值 为 MotionEvent.ACTION - 
DOWN; 当 用 户 将 触 控 物体 离开 屏幕 时 ，MotionEvent.getAction0 的 值 为 MotionEvent. 
ACTION UP; 当 触 控 物体 在 屏幕 上 滑动 时 ，MotionEvent.getAction(0) 的 值 为 MotionEvent. 
ACTION MOVE. onTouchEvent 方法 的 返回 值 为 true 表示 事件 处 理 完成 ， 返回 false 表示 未 


完成 。 


(4) public boolean onTrackballEvent (MotionEvent event) 方法 的 功能 是 处 理 手 机 中 轨迹 
球 的 相关 事件 ， 可 以 在 Activity 中 重 写 ， 也 可 以 在 View 中 被 重 写 。 参 数 event 为 手机 轨迹 球 


事件 封装 类 的 对 象 。 该 方法 的 返回 值 为 true 表示 事件 处 理 
完成 ， 返 回 false 表示 未 完成 。 

(5) protected void onFocusChanged (boolean gainFocus, 
int direction, Rect previouslyFocusedRect) 方法 只 能 在 View 
中 重 写 ， 当 View 组 件 焦 点 改变 时 被 自动 调用 ， 参 数 
gainFocus 表示 触发 该 事件 的 View 是 否 获得 了 焦点 ， 获 得 


previouslyFocusedRect 是 在 触发 事件 的 View 的 坐标 系 中 
前 一 个 获得 焦点 的 矩形 区 域 。 


4.9.3 ”界面 事件 响应 实例 


在 之 前 的 章节 中 ， 多 次 使 用 了 监听 器 对 事件 进行 处 
理 ， 读 者 应 该 已 经 很 熟悉 了 。 本 节 通 过 一 个 实例 来 演示 回 
调 事件 响应 的 处 理 过程 ， 该 实例 EventDemo 运行 效果 如 
图 4.50 所 示 。 

其 布局 文件 main.xml 内 容 如 下 : 


<?xml version="1.0" encoding="utf-8"?> 
<LinearLayout 


al EventDemo 
回调 事件 处 理 演示 


按钮 1 ”按钮 2 按钮 3 


图 4.50 ”实例 EventDemo 运行 效果 


xmlns:android="http://schemas.android.com/apk/res/android" 


android: layout_width="fill parent" 
android: layout_height="fill parent" 
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android:orientation-"vertical"» 


«TextView 
android:layout width-"fill parent" 
android:layout height-"wrap content" 
android:text-"/J f ANE 1> 
«LinearLayout 
android:layout width- "wrap content" 
android:layout height-"wrap content" 
android:orientation-"horizontal"» 
«Button 
android: id="@+id/button1" 
android: layout_width="wrap_ content" 
android:layout height-"wrap content" 
android:focusableInTouchMode- "true" 
android:text-"/7//1"/» 
«Button 
android: id="@+id/button2" 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:focusableInTouchMode- "true" 
android:text-"/7//2"/» 
«Button 
android: id="@+id/button3" 
android: layout_width="wrap_ content" 
android:layout height-"wrap content" 
android:focusableInTouchMode- "true" 
android:text-"/7/73"/» 
</LinearLayout> 


</LinearLayout> 


当 用 户 在 屏幕 上 做 移动 触摸 、 单 击 按钮 等 操作 时 ， 主 Activity EventDemo 会 捕获 相应 事 
件 并 进行 处 理 ， 在 LogCat 中 打印 相关 内 容 ， 运 行 效果 如 图 4.51 所 示 。 
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Application Tag Text 

introduction. android.eventDemo enentDemo 第 一 个 技 钮 获得 了 焦点 
introduction.android.eventDemo enentDemo 第 二 个 技 钮 获得 了 集 
introduction.android.eventDemo enentDemo 手指 正在 往 屏 莫 上 技 下 
introduction. android.eventDemo enentDemo 手指 正在 屏幕 上 移动 
introduction.android.eventDemo enentDemo 手指 正在 屏 莫 上 移动 
introduction.android.eventDemo enentDemo 手指 正在 屏幕 上 移动 
introduction.android.eventDemo enentDemo 手指 正在 屏 莫 上 移动 
introduction.android.eventDemo enentDemo 手指 正在 屏幕 上 移动 
introduction. android.eventDemo enentDemo 手指 正在 屏幕 上 移动 
introduction.android.eventDemo enentDemo 手指 正在 从 屏幕 上 拍 起 


图 4.51 Activity EventDemo 捕获 事件 
EventDemo java 代码 如 下 : 


package introduction.android.eventDemo; 


import android.app.Activity; 
import android.content.Context; 
import android.graphics.Rect; 
import android.os.Bundle; 

import android.util.Log; 

import android.view.KeyEvent; 
import android.view.MotionEvent; 
import android.view.View; 

import android.view.View.OnFocusChangeListener; 
import android.widget.Button; 
import android.widget.Toast; 


public class EventDemo extends Activity implements 
OnFocusChangeListener { 

Button[] buttons=new Button[3]; 

@Override 

public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState) ; 
setContentView (R.layout.main) ; 
buttons[0]= (Button) findViewById (R.id.button1) ; 
buttons[1]= (Button) findViewById (R.id.button2) ; 
buttons[2]= (Button) findViewById (R.id.button3) ; 
for (Button button :buttons) { 

button.setOnFocusChangeListener (this) ; 


} 
// 按 钮 按 下 触发 的 事件 


public boolean onKeyDown (int keyCode,KeyEvent event) 


{ 
switch (keyCode) 
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case KeyEvent .KEYCODE_DPAD_UP: 


DisplayInformation ("}% F EÝ iji, KEYCODE DPAD UP") 


break; 
case KeyEvent.KEYCODE DPAD DOWN: 


DisplayInformation (" 按 下 下 方向 键 ，KEYCODE_DPAD_UP") 


break; 


} 
return false; 


} 
// 按 钮 弹 起 触发 的 事件 
public boolean onKeyUp (int keyCode,KeyEvent event) 
{ 
switch (keyCode) 


{ 
case KeyEvent .KEYCODE_DPAD_UP: 


DisplayInformation (" 松 开 上 方向 键 ，KEYCODE DPAD UP") 


break; 
case KeyEvent .KEYCODE_DPAD_DOWN: 


DisplayInformation ("fAJF F} iit, KEYCODE DPAD UP") 


break; 


} 
return false; 


} 


// 触 摸 事 件 


public boolean onTouchEvent (MotionEvent event) 
{ 
switch (event.getAction()) { 
case MotionEvent .ACTION_DOWN: 
DisplayInformation (" 手 指正 在 往 屏幕 上 按 下 ") 
break; 
case MotionEvent.ACTION MOVE: 
DisplayInformation (" 手 指正 在 屏幕 上 移动 ") ; 
break; 
case MotionEvent.ACTION UP: 
DisplayInformation (" 手 指正 在 从 屏幕 上 抬 起 ") 


break; 


return false; 


// 焦 点 事件 
@Override 
public void onFocusChange (View view, boolean arg1) { 
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switch (view.getId()) { 

case R.id.buttonl: 
DisplayInformation ("第 一 个 按钮 获得 了 焦点 ") ; 
break; 

case R.id.button2: 
DisplayInformation ("第 二 个 按钮 获得 了 焦点 ") ; 
break; 

case R.id.button3: 
DisplayInformation ("第 三 个 按钮 获得 了 焦点 ") ; 
break; 

} 

} 


// 显 示 Toast 
public void DisplayInformation (String string) 
{ 
//Toast.makeText 
(EventDemo.this,string,Toast.LENGTH SHORT) .show(); 
Log.i ("enentDemo",string) ; 


小 结 


本 章 介绍 了 使 用 Android SDK 进行 用 户 界面 设计 开发 过 程 中 涉及 的 相关 知识 。 介 绍 了 常 
用 的 Widget 组 件 以 及 布局 的 使 用 方法 ; 介绍 了 菜单 (Menu) 和 活动 栏 (ActionBar) 结合 使 
用 的 方法 ; 介绍 了 AlertDialog 和 ProgressDialog 对 话 框 的 使 用 方法 ; 介绍 了 Toast 和 
Notification 的 使 用 方法 。 每 一 部 分 都 辅 以 实例 ， 希 望 可 以 帮助 读者 对 各 个 组 件 的 使 用 方法 进 
行 掌握 ， 使 以 后 在 Android UI 的 设计 中 能 有 游 妃 有余 。 本 章 最 后 简单 介绍 了 Android 系统 框 
架 提供 的 组 件 与 用 户 之 间 的 交互 事件 的 两 种 处 理 方法 ， 分 别 为 事件 监听 器 和 系统 回调 方法 。 

由 于 篇 幅 有 限 ， 在 本 章 中 不 可 能 将 用 户 界面 设计 中 涉及 的 所 有 组 件 进行 全 面 介绍 ， 读 者 
可 以 参阅 Android SDK 文档 获取 更 多 的 知识 。 


^. || 思考 题 


1. 为 什么 要 使 用 布局 ? 
2. 使 用 TextView、EditText 和 Button 组 件 实现 一 个 简单 的 计算 器 。 
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3. 实现 一 个 输入 密码 框 。 在 EditText 中 输入 密码 ， 当 输入 密码 时 显示 “@@”, 在 下 方 添 
加 一 个 CheckBox 用 来 选择 是 否 “ 显 示 密 码 ”。 
4. 举例 说 明 CheckBox 与 RadioGroup 的 区 别 有 哪 些 。 
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从 本 章节 可 以 学 习 到 : 


** Intent 

^ 拨号 程序 
o 短信 程序 
学 “照相 机 程序 
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手机 的 基本 功能 是 打 电 话 和 发 短信 。 本 章 通 过 Intent 的 使 用 来 介绍 在 Android 系统 下 如 
何 对 电话 和 短信 应 用 程序 进行 开发 。 通 过 Intent， 程 序 员 可 以 方便 地 将 自己 开发 的 应 用 程序 
与 手机 中 的 其 他 应 用 组 件 进行 交互 。 


Intent 


Intent 被 译作 “意图 ”， 在 Android 中 提供 了 Intent 机 制 来 协助 应 用 间 的 交互 与 通信 。 
Intent 负责 对 应 用 中 一 次 操作 的 动作 、 动 作 涉 及 数据 、 附 加 数据 进行 描述 ，Android 则 根据 此 
Intent 的 描述 ， 负 责 找到 对 应 的 组 件 ， 将 Intent 传递 给 调用 的 组 件 ， 并 完成 组 件 的 调用 。Intent 
不 仅 可 用 于 应 用 程序 之 间 ， 也 可 用 于 应 用 程序 内 部 Activity/Service 之 间 的 交互 。 因 此 ， 可 以 
将 Intent 理解 为 不 同 组 件 之 间 通 信 的 “媒介 ”， 专 门 提供 组 件 互相 调用 的 相关 信息 。 

Intent 是 对 它 要 完成 的 动作 的 一 种 抽象 描述 ，Intent 封装 了 它 要 执行 动作 的 属性 : Action 
(动作 ) . Data (数据 ) ~ Category 〈 类 别 ) . Type (HA!) 、Component (组 件 信息 ) 和 
Extras〔 附 加 信息 〉。 

1. Action 

Action 是 指 Intent 要 实施 的 动作 ， 是 一 个 字符 串 常量 。 如 果 指 明了 一 个 Action， 执 行者 
就 会 依照 这 个 动作 的 指示 ， 接 受 相关 输入 ， 表 现 对 应 行为 ， 产 生 符合 条 件 的 输出 。 

在 Intent 类 中 ， 定 义 了 大 量 的 Action 常量 属性 ， 标 准 的 Activity Actions 如 表 5.1 所 示 。 


表 5.1 标准 的 Activity Actions 


动作 名 称 


ACTION MAIN 


ACTION_ VIEW 


用 于 指定 一 些 数据 应 该 附属 于 哪些 地 方 ， 例 如 ， 图 片 数 据 应 该 附属 于 联 


ACTION ATTACH DATA 


RA 
ACTION EDIT 访问 已 给 的 数据 ， 提 供 明确 的 可 编辑 接口 
ACTION PICK 从 数据 中 选择 一 个 子 项 目 ， 并 返回 所 选中 的 项 目 
ACTION_CHOOSER 显示 一 个 activity 选择 器 ， 允 许 用 户 在 进程 之 前 选择 他 们 想 要 的 
允许 用 户 选择 特殊 种 类 的 数据 ， 并 返回 〈 特 殊 种 类 的 数据 : 照 一 张 相片 
ACTION_GET_CONTENT 
Se 或 录 一 段 音 ) 
拨打 一 个 指定 的 号 码 ， 显 示 一 个 带 有 号 码 的 用 户 界面 ， 允 许 用 户 去 启动 
ACTION_DIAL 呼叫 
ACTION_CALL 根据 指定 的 数据 执行 一 次 呼叫 
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(BER) 
动作 名 称 动作 功能 
ACTION SEND 传递 数据 ， 被 传送 的 数据 没有 指定 
ACTION SENDTO 发 送 一 个 信息 到 某 个 指定 的 人 


ACTION ANSWER 处 理 一 个 打 进 电话 呼叫 
ACTION INSERT 插入 一 条 空 项 目 到 已 给 的 容器 


ACTION DELETE 从 容器 中 删除 已 给 的 数据 
ACTION RUN 运行 数据 
ACTION_SYNC 同步 执行 一 个 数据 


ACTION PICK ACTIVITY 为 已 知 的 Intent 选择 一 个 Activity， 返 回 被 选中 的 类 


ACTION SEARCH 执行 一 次 搜索 
ACTION WEB SEARCH 执行 一 次 web 搜索 
ACTION FACTORY TEST 工厂 测试 的 主要 进入 点 


2. Data 

Intent 的 Data 属性 是 执行 动作 的 URI 和 MIME 类 型 ， 不 同 的 Action 有 不 同 的 Data 数据 
指定 。 例 如 ， 通 讯 录 中 identifier 为 1 联系 人 的 信息 (一 般 以 U 形式 被 描述 )》， 给 这 个 人 打 电 
话 的 的 语句 为 : 


ACTION_VIEW content://contacts/1 
ACTION_DIAL content://contacts/1 


3. Category 

Intent 中 的 Category 属性 起 着 对 Action 补充 说 明 的 作用 。 通 过 Action, AU Data BK Type 
可 以 准确 表达 出 一 个 完整 的 意图 (加 一 些 约束 会 更 精准 ) 。Intent 中 的 Category 属性 是 一 个 
执行 Action 的 附加 信息 。 例 如 ，CAIEGORY _ LAUNCHER 表 示 加 载 程序 时 Activity 出 现在 最 
ihi; _HOME 表示 回 到 Home 界面 。 

4. Type 

Intent 的 Type 属性 显示 指定 Intent 的 数据 类 型 (MIME) 。 通 常 Intent 的 数据 类 型 可 以 从 
Data 自身 判断 出 来 ， 但 是 一 旦 指定 了 Type 类 型 ， 就 会 强制 使 用 Type 指定 的 类 型 而 不 再 进行 
推导 。 

5. Component 

Intent 的 Compotent 属性 指定 Intent 的 目标 组 件 的 类 名 称 。 通 常情 况 下 ，Android 会 根据 
Intent 中 包含 的 其 他 属性 的 信息 进行 查找 ， 比 如 用 Action, Data, Type. Category 去 描述 一 个 
请 求 ， 这 种 模式 称 为 Implicit Intents。 通 过 这 种 模式 ， 提 供 一 种 灵活 可 扩展 的 模式 ， 给 用 户 和 
第 三 方 应 用 一 个 选择 权 。 例 如 ， 一 个 邮箱 软件 ， 大 部 分 功能 都 不 错 ， 但 是 选择 图 片 的 功能 不 
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尽 人 意 ， 如 果 采 用 Implicit Intents， 那 么 它 就 是 一 个 开放 的 体系 ， 如 果 想 用 手机 中 的 其 他 图 片 
代替 邮箱 中 默认 的 ， 可 以 完成 这 一 功能 。 但 该 模式 需要 付出 性 能 上 的 开销 ， 因 为 毕竟 存在 一 


个 检索 过 程 。 于 是 Android 提供 了 另 一 种 模式 Explicit Intents , 
Component 就 是 完整 的 类 名 ， 形 如 com.xxxxx.xxxx , 
是 否 


电子 邮件 ”这 个 动作 请 求 ， 可 以 将 电子 邮件 的 subject, body 等 保存 在 extras H 


被 指定 ，Intent 可 分 为 显 式 Intent 和 隐 式 Intent. 
6. Extra 


该 模式 需要 component 对 象 。 
- 旦 指明 就 可 以 直接 调用 。 根 据 该 属性 


Intent 的 Extra 属性 是 添加 一 些 组 件 的 附加 信息 。 比 如 ， 要 通过 一 个 Activity 执行 “发 送 


件 发 送 组 件 。 


5.1 


的 前 提 下 ， 这 种 方式 一 般 在 应 用 程序 内 部 实现 。 比 如 在 某 应 用 程序 内 ， 


.{ st Intent FA Intent 


Intent 寻找 目标 组 件 的 方式 分 为 两 种 ， 显 式 Intent 和 隐 式 Intent. 


且 ， 传 给 电子 邮 


显 式 Intent 是 通过 指定 Intent 组 件 名 称 来 实现 的 ， 它 一 般 用 在 源 组 件 已 知 目标 组 件 名 称 


个 Service。 
在 不 同 应 用 程序 之 间 ， 在 不 知道 目标 组 件 名 称 的 情况 下 ， 寻 找 目标 组 件 需要 使 用 隐 式 
Intent。 这 种 方式 是 通过 Intent Filter 实现 的 。 


5.1 


148 


.2 IntentFilter 


-个 Activity 启动 一 


为 了 支持 隐 式 Intent， 可 以 声明 一 个 甚至 多 个 IntentFilter。 每 个 IntentFilter 描述 组 件 所 能 
响应 Intent 请 求 的 能 力 。 比 如 请 求 网 页 浏览 器 ， 网 页 浏览 器 程序 的 IntentFliter 就 应 该 声明 它 
所 希望 接收 的 IntentFilter Action 是 WEB SEARCH. ACTION， 以 及 与 之 相关 的 请 求 数据 是 网 
页 地 址 URI 格 式 。 
如 何 为 组 件 声明 自己 的 IntentFilter? 常见 的 方法 是 在 Android Manifest.xml 文件 中 用 属性 
<Intent-Filter> 描 述 组 件 的 IntentFilter。 
-个 隐 式 Intent 请 求 要 能 够 传递 目标 组 件 ， 必 要 通过 Action, Data 以 及 Category 这 三 个 
方面 的 检查 。 如 果 任 何 一 方面 不 匹配 ，Android 都 不 会 将 该 隐 式 Intent 传递 给 目标 组 件 。 接 下 
来 我 们 讲解 这 三 方面 检查 的 具体 规则 。 


1. 动作 测试 


<intent-Filter> 元 素 中 可 以 包含 子 元 素 <action>， 比 如 : 
<intent-Filter> 


«action android:name- *com.example.project.SHOW-CURRENT" /> 


«action android:name- *com.example.project.SHOW-RECENT" /» 
«action android:name- *com.example.project.SHOW-PENDING" /» 
</intent-Filter> 
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一 条 <intent-Filter> 元 素 至 少 包含 一 个 <action>， 和 否则 任何 Intent 请 求 都 不 能 和 该 <intent- 
Filter> 匹 配 。 
如 果 Intent 请 求 的 Action 和 <intent-Filter> 中 的 革 一 条 <action> 匹 配 ， 那 么 该 Intent 就 通过 
了 这 条 <intent-Filter> 的 动作 测试 。 
如 果 Intent 请 求 或 者 <intent-Filter> 中 没有 说 明 具 体 的 Action 类 型 ， 那 么 就 会 出 现下 面 这 
两 种 情况 。 
© 如 果 <intent-Filter> 中 没有 包含 任何 Action 类 型 ， 那 么 无 论 什么 Intent 请 求 都 无 法 和 这 
条 <intent-Filter> 匹 配 。 
e E, de Intent 请 求 中 没有 设 定 Action 类 型 ， 那 么 只 要 <intent-Filter> 中 包含 有 
Action 类 型 ， 这 个 Intent 请 求 就 将 顺利 通过 <intent-Filter> 的 行为 测试 。 


2. 类 别 测试 


<intent-Filter> 元 素 可 以 包含 <category> 子 元 素 ， 比 如 : 
<intent-Filter> 

<category android:name= “android.Intent.Category.DEFALT” /> 
«category android:name= “android. Intent .Category.BROWSABLE” /> 
</intent-Filter> 


AA Intent 请 求 中 所 有 的 Category 与 组 件 中 某 一 个 Intent 的 <catetory> 完 全 匹配 时 ， 才 
会 让 该 Intent 请 求 通过 测试 ，IntentFilter 中 多 余 的 <category> 声 明 并 不 会 导致 匹配 失败 。 一 个 
没有 指定 任何 类 别 测试 的 IntentFliter 仅仅 匹配 没有 设置 类 别 的 Intent 请 求 。 


3. 数据 测试 
数据 在 <intent-Filter> 中 的 描述 如 下 : 


<intent-Filter> 

«data android:type- *video/mpeg" android:scheme= “http” .../» 
«data android:type- *audio/mpeg" android:scheme= “http” ...../> 

«/intent-Filter» 


<data> 元 素 指定 了 要 接受 的 Intent 请 求 的 数据 URI 及 数据 类 型 ， 其 中 URI 被 分 成 三 部 分 
来 进行 匹配 : scheme, authority 和 path. Hj setData0 设 定 的 Intent 请 求 的 URI 数据 类 型 和 
scheme 必须 与 IntentFilter 中 所 指定 的 一 致 。 若 IntentFilter 中 还 指定 了 authority 或 path， 它 们 
也 需要 匹配 才 会 通过 测试 。 


9.4L SRI 
借助 于 Intent， 可 以 轻松 实现 拨打 电话 的 应 用 程序 。 只 需 声明 一 个 拨号 的 intent 对 象 ， 并 
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使 用 startActivity0 方 法 启动 即 可 。 

创建 Intent 对 象 的 代码 为 Intent intent=new Intent (action,uri) ， 其 中 uri 是 要 拨 叫 的 号 码 
数据 ， 通 过 Uriparse0 方 法 把 “tel:1234” 格 式 的 字符 串 转换 为 URL m action 有 两 种 使 用 方 
X: 一 种 是 Intent.Action CALL， 直 接 进 行 呼叫 方式 ， 这 种 方式 需要 应 用 程序 具有 
android.permission.CALL_PHONE 权限 。 另 外 一 种 是 Intent.Action DIAL， 这 种 不 是 不 直接 进 
行 呼叫 ， 而 是 启动 Android 系统 的 拨号 应 用 程序 ， 然 后 由 用 户 进行 拨号 。 这 种 方式 不 需要 任 


何 权限 的 设置 。 
实例 phoneDemo 演示 了 使 用 Intent.Action CALL 方式 进行 拨号 的 过 程 ， 运 行 效果 如 图 
5.1 所 示 。 


图 5.1 使 用 Intent.Action CALL 方式 拨号 


在 实例 phoneDemo 中 main.xml 的 代码 如 下 : 


<?xml version="1.0" encoding="utf-8"?> 
<LinearLayout 
xmlns:android-"http://schemas.android.com/apk/res/android" 
android:orientation-"vertical" 
android:layout width-"fill parent" 
android:layout height-"fill parent" 
> 
<EditText 
android: layout_marginTop="30dp" 
android:layout width-"fill parent" 
android:layout height-"wrap content" 
android: id="@+id/edittext" 
android: layout_marginLeft="40dp" 
/> 
<Button 
android:layout width-"wrap content" 
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android:layout height-"wrap content" 
android: text=" H Ei" z 
android:id="@+id/button" 
android: layout_marginLeft="80dp" 
android: layout_marginTop="40dp" 
/> 

</LinearLayout> 


在 实例 phoneDemo 中 AndroidManifest.xml 的 代码 如 下 : 


<?xml version="1.0" encoding="utf-8"?> 
«manifest xmlns:android-"http://schemas.android.com/apk/res/android" 
package- "introduction.android.phone" 
android:versionCode- "1" 
android:versionName-"1.0"» 
«uses-sdk android:minSdkVersion-"10" /> 
«application android:icon-"edrawable/icon" 
android:label-"estring/app name" 
«activity android:name=".PhoneDemoActivity" 
android:label-"estring/app name"» 
<intent-filter> 
<action android:name="android.intent.action.MAIN" /> 
<category 
android:name="android.intent.category.LAUNCHER" /> 
</intent-filter> 
</activity> 
</application> 
«uses-permission android:name- "android.permission.CALL PHONE"»«/uses- 
permission» 
«/manifest» 


在 实例 phoneDemo 中 的 PhoneDemoActivity.java 的 具体 实现 代码 如 下 : 


package introduction.android.phone; 
import android.app.Activity; 
import android.content.Intent; 
import android.net.Uri; 
import android.os.Bundle; 
import android.view.View; 
import android.view.View.OnClickListener; 
import android.widget.Button; 
import android.widget.EditText; 
public class PhoneDemoActivity extends Activity { 
/** Called when the activity is first created. */ 
private Button button; 
private EditText edittext; 
@Override 
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public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState) ; 
setContentView (R.layout.main) ; 
button- (Button) findViewById (R.id.button) ; 
button.setOnClickListener (new buttonListener()) ; 
5 
class buttonListener implements OnClickListener{ 
QGOverride 
public void onClick (View v) ( 
// TODO Auto-generated method stub 
edittext= (EditText) findViewById (R.id.edittext) ; 
String number-edittext.getText().toString(); 
Intent intent-new Intent (Intent.ACTION CALL,Uri.parse 
("tel:"+number) ) ; 
startActivity (intent) ; 
} 


其 中 ， 
Intent intent-new Intent (Intent.ACTION CALL, Uri.parse 
("tel:"+number) ) ; 
startActivity (intent) ; 
通过 Intent. ACTION. CALL 建立 了 一 个 进行 拨号 的 intent 请 求 ， 并 使 用 startActivity 直接 
启动 Android 系统 的 拨号 程序 进行 呼叫 。 
若 在 实例 PhoneDemo 中 ， 将 PhoneDemoActivityjava 中 的 代码 : 


Intent intent=new Intent (Intent.ACTION_CALL,Uri.parse 
("tel:"+number) ) ; 
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修改 为 : 


Intent intent=new Intent 
(Intent.ACTION DIAL,Uri.parse ("tel:"+number) ) ; 


后 ， 单 击 “ 拨 打 电 话 ” 按 钮 后 不 再 直接 呼叫 ， 而 是 只 运行 


Android 系统 默认 的 拨号 程序 ， 用 户 还 拥有 进一步 决定 下 一 步 操 
作 的 权限 ， 运 行 效果 如 图 5.2 所 示 。 


图 5.2 拨打 电话 
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5.3 短信 程序 


5.31 SMS 简介 


SMS (Short Message Service) 即 短信 息 服 务 ， 它 是 一 种 存储 和 转发 服务 。 也 就 是 说 ， 短 
信息 并 不 是 直接 从 发 信人 发 送 到 接收 人 ， 而 始终 通过 SMS 中 心 进 行 转发 。 如 果 接 收 人 处 于 未 
连接 状态 (可 能 电话 已 关闭 ) ， 则 信息 将 在 接收 人 再 次 连接 时 发 送 。 


5.3.2 ”接收 短信 
要 使 Android 应 用 程序 能 够 接收 短信 息 ， 需 要 以 下 三 个 步 又 : 


CX) Android 应 用 程序 必须 具有 接收 SMS 短信 息 的 权限 ， 在 AndroidManifest.xml 文 件 中 
配置 如 下 : 


<uses-permission android:name="android.permission.RECEIVE_SMS"/> 


© Android 应 用 程序 需要 定义 一 个 BroadcastReceiver 的 子 类 ， 并 通过 重 载 其 public 
void onReceive ( Context arg0, Intent arg] ) 方法 来 处 理 接 收 到 短信 息 的 事件 。 
€X303 在 AndroidManifest.xml 文件 中 对 BroadcastReceiver 子 类 的 <intent-filter> 属 性 进行 配 
HL, 使 其 能 够 获取 到 短信 息 接收 action。 配 置 如 下 : 
<intent-filter> 
<action 


android:name="android.provider.Telephony.SMS_RECEIVED"/> 
</intent-filter> 


5.3.3 ”接收 短信 实例 
实例 receiveMessageDemo 演示 了 接收 短信 并 提示 的 过 程 ， 运 行 效果 如 图 5.3 所 示 。 
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m 
P" ReceiveMessageDemo 


waitin 


发 信人 : 
15555215556f8 38 : 
Receive Message Demo 


图 5.3 receiveMessageDemo 实例 
其 layout 文件 main.xml 代码 如 下 : 


<?xml version-"1.0" encoding-"utf-8"?» 
«LinearLayout 
xmlns:android-"http://schemas.android.com/apk/res/android" 
android:layout width-"fill parent" 
android:layout height-"fill parent" 
android:orientation-"vertical"» 
«EditText 
android: id="@+id/editText1" 
android:layout width-"match parent" 
android:layout height-"wrap content "> 
«requestFocus /» 
«/EditText» 
</LinearLayout> 


AndroidManifest.xml 文件 代码 如 下 : 


<?xml version="1.0" encoding="utf-8"?> 
«manifest xmlns:android-"http://schemas.android.com/apk/res/android" 
package- "introduction.android.receiveMessage" 
android:versionCode-"1" 
android:versionName-"1.0"» 
«uses-sdk android:minSdkVersion="14" /» 
«uses-permission android:name- "android.permission.RECEIVE SMS"/» 
«application 
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android:icon-"edrawable/ic launcher" 
android: label="@string/app_name"> 
<activity android:name=".ReceiveMessageDemoActivity" 
android: label="@string/app_name"> 
<intent-filter> 
<action android:name="android.intent.action.MAIN" /> 
<category 
android:name="android.intent.category.LAUNCHER" /> 
</intent-filter> 
</activity> 
<receiver android:name="SmsReciver"> 
<intent-filter> 
<action 
android:name="android.provider.Telephony.SMS_RECEIVED"/> 
</intent-filter> 
</receiver> 
</application> 
</manifest> 


ReceiveMessageDemoActivity.java 代码 如 下 : 


package introduction.android.receiveMessage; 


import android.app.Activity; 
import android.os.Bundle; 
import android.widget.EditText; 


public class ReceiveMessageDemoActivity extends Activity { 

/** Called when the activity is first created. */ 

@Override 

public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState) ; 
setContentView (R.layout.main) ; 
EditText text= (EditText) this.findViewById (R.id.editText1) ; 
text.setText ("waiting...") ; 


Intent 广播 接收 器 定义 为 SmsReciver， 用 于 对 接收 到 短信 息 的 事件 进行 处 理 。SmsReciver. 
java 代码 如 下 : 


package introduction.android.receiveMessage; 
import android.content .BroadcastReceiver; 
import android.content.Context; 

import android.content.Intent; 

import android.os.Bundle; 


156 


第 5 章 ”电话 和 短信 应 用 程序 开发 


import android.telephony.SmsMessage; 
import android.widget.Toast; 
public class SmsReciver extends BroadcastReceiver { 
StringBuilder strb=new StringBuilder (); 
@Override 
public void onReceive (Context arg0, Intent argl) { 
// TODO Auto-generated method stub 
Bundle bundle-argl.getExtras(); 
Object[] pdus- (Object[]) bundle.get ("pdus") ; 
SmsMessage[] msgs-new SmsMessage[pdus.length]; 
for (int i=0; i«pdus.length; i++) { 
msgs [i]-SmsMessage.createFromPdu ( (byte[]) pdus[i]) ; 


} 
for (SmsMessage msg : msgs) { 
strb.append (" 发 信人 : \n") ; 
strb.append (msg.getDisplayOriginatingAddress()) ; 
strb.append ("\n 信息 内 容 ，\n") ; 
strb.append (msg.getDisplayMessageBody()) ; 


Toast.makeText (arg0, strb.toString(), 
Toast.LENGTH LONG) .show(); 


J 
} 


当 接 收 到 短信 息 后 ，onReceive 方法 被 调用 。 由 于 Android 设备 接收 到 的 SMS 短信 息 是 
PDU (Protocol Description Unit) 形式 ， 因 此 通过 Bundle 类 对 象 获 取 到 pdus， 并 创建 
SmsMessage 对 象 。 然 后 从 SmsMessage 对 象 中 提取 出 短信 息 的 相关 信息 ， 并 存储 到 
StringBuilder 类 的 对 象 中 ， 最 后 使 用 Toast 显示 出 来 。 

测试 该 实例 时 ， 可 通过 AVD Mananger， 再 启动 一 个 AVD， 通 过 AVD 的 短信 程序 向 当前 
AVD 号 码 发 送 短信 ， 就 可 使 该 实例 被 触发 运行 。 


5.3.4 ”发 送 短 信 


要 实现 发 送 短信 功能 需要 在 AndroidMainfestxml 文件 中 注册 发 送 短信 的 权限 : <uses- 
permission android:name="android.permission.SEND_SMS'"/>， 然 后 才 可 以 使 用 发 送 短信 功能 。 

发 送 短信 使 用 的 是 android.telephony.SmsManager 类 的 sendTextMessage 方法 ， 该 方法 定 
义 如 下 ; 

public void sendTextMessage ( String destinationAddress, String scAddress, String text, 
PendingIntent sentIntent, PendingIntent deliveryIntent ) 

其 中 ， 各 个 参数 意义 如 下 : 


* destinationAddress: 表示 接收 短信 的 手机 号 码 
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© scAddress: 短信 服务 中 心 号 码 ， 设 置 为 null 的 话 表示 使 用 手机 默认 的 短信 服务 中 心 
© text: 要 发 送 的 短信 内 容 

* sentIntent: 当 消 息 被 成 功 发 送 给 接收 者 时 ， 广 播 该 PendingIntent 

* deliveryIntent: 当 消息 被 成 功 发 送 时 ， 广 播 该 PendingIntent 


5.3.5 ”短信 发 送 实 例 


实例 sendMessageDemo 演示 了 发 送 短信 的 过 程 ， 其 运行 效果 如 图 5.4 所 示 。 


wo de di yi ge 


图 5.4 sendMessageDemo 实例 
在 实例 sendMessageDemo 中 的 main.xml 代码 如 下 : 


<?xml version-"1.0" encoding-"utf-8"?» 
«LinearLayout 
xmlns:android-"http://schemas.android.com/apk/res/android" 
android:orientation-"vertical" 
android:layout width-"fill parent" 
android:layout height-"fill parent" 
E 
«LinearLayout 
android:orientation-"horizontal" 
android:layout width-"fill parent" 
android:layout height-"wrap content" 
> 
<TextView 
android: layout_width="wrap content" 
android: layout_height="wrap_content" 
android: id="@+id/textview01" 
android: text=" fA: " 
android: layout_marginLeft="15dp" 
J=: 
<EditText 
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android: layout_marginLeft="20dp" 
android: layout_width="fill_ parent" 
android: layout_height="wrap_content" 
android: id="@+id/edittext01" 

We 


</LinearLayout> 
<LinearLayout 
android: orientation="horizontal" 
android: layout_width="fill_ parent" 
android:layout height-"wrap content" 
android:layout marginTop-"30dp" 
> 
<TextView 
android: layout_width="wrap_ content" 
android:layout height-"wrap content" 
android: id="@+id/textview02" 
android: text="@string/receiver" 
android: layout_marginLeft="15dp" 
/? 
«EditText 
android:layout marginLeft-"10dp" 
android:layout width-"fill parent" 
android:layout height-"wrap content" 
android: id="@+id/edittext02" 
/> 
</LinearLayout> 
<Button 
android: layout_width="wrap_ content" 
android:layout height-"wrap content" 
android: id="@+id/button" 
android: layout_marginLeft="100dp" 
android: layout_marginTop="30dp" 
android: text="@string/msg" 
/> 
</LinearLayout> 


在 实例 sendMessageDemo 中 的 AndroidManifest.xml 代码 如 下 : 


<?xml version="1.0" encoding="utf-8"?> 
«manifest xmlns:android-"http://schemas.android.com/apk/res/android" 
package-"introduction.android.SendMessage" 
android:versionCode-"1" 
android:versionName-"1.0"» 
«uses-sdk android:minSdkVersion="10" /» 
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<application android:icon="@drawable/icon" 
android: label="@string/app_name"> 
<activity android:name=".SendMessageDemoActivity" 
android: label="@string/app_name"> 
<intent-filter> 
<action android:name="android.intent.action.MAIN" /> 
<category 
android:name="android.intent.category.LAUNCHER" /> 
</intent-filter> 
</activity> 
</application> 
«uses-permission android:name-"android.permission.SEND SMS"/» 
«/manifest» 


在 实例 sendMessageDemo 中 的 SendMessageDemoActivityjava 实现 了 发 送 短信 的 功能 ， 
其 代码 如 下 : 


package introduction.android.SendMessage; 
import android.app.Activity; 

import android.os.Bundle; 

import android.telephony.SmsManager; 
import android.view.View; 

import android.view.View.OnClickListener; 
import android.widget.Button; 

import android.widget.EditText; 

import android.widget.Toast; 


public class SendMessageDemoActivity extends Activity { 
/** Called when the activity is first created. */ 
private Button button; 
private EditText edittext01,edittext02; 
@Override 
public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState) ; 
setContentView (R.layout.main) ; 
button= (Button) findViewById (R.id.button) ; 
button.setOnClickListener (new buttonListener()) ;// 为 发 送 按钮 添加 
监听 器 
class buttonListener implements OnClickListener{ 


@Override 

public void onClick (View v) { 
// TODO Auto-generated method stub 
edittext01- (EditText) findViewById (R.id.edittext01) 
edittext02- (EditText) findViewById (R.id.edittext02) 
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String number-edittext01.getText().toString(); 


// 获 取 手 机 号 码 
String message01-edittext02.getText().toString(); 
// 获 取 短 信 内 容 
if (number.equals ("") || message01.equals ("") ) 
// 判 输入 是 否 有 空 内 容 


{ 
Toast.makeText (SendMessageDemoActivity.this, " 输 


入 有 误 ， 请 检查 输入 "，Toast .LENGTH LONG) .show(); 
else{ 
SmsManager massage-SmsManager.getDefault(); 
massage.sendTextMessage (number, null, message01, 
null, null) ; 
// 调 用 senaTextMessage 方法 来 发 送 短信 
Toast.makeText (SendMessageDemoActivity.this, "短信 
发 送 成 功 "，Toast .LENGTH_LONG) .show() ; 
} 
} 
} 
} 


在 实际 应 用 该 短信 发 送 程序 时 ， 要 注意 一 些 限制 问题 ， 比 如 接收 手机 号 码 的 格式 ， 短 信 
内 容 超 过 预定 字符 的 提示 等 。 一 般 情 况 下 ， 手 机 号 码 格式 可 以 使 用 Pattern 来 设置 ， 此 外 
Android SDK 也 提供 了 PhoneNumberUtils 类 来 对 电话 号 码 格式 进行 处 理 ， 而 短信 内 容 超 过 70 
个 字符 会 被 自动 分 解 为 多 条 短信 发 送 ， 在 此 不 作 具 体 描述 。 


ha " A 
J.A 照相 机 程序 
借助 于 Intent， 可 以 方便 地 调用 Android 系统 的 照相 机 程序 进行 拍照 。 但 是 需要 声明 摄像 


头 的 使 用 权限 ， 即 在 AndroidManifestxml 文件 中 添加 如 下 代码 : 


«uses-permission android:name-"android.permission.CAMERA"/» 
«uses-feature android:name-"android.hardware.camera"/» 


i 


实例 CameraDemo 演示 了 通过 Intent 调用 系统 的 拍照 程序 并 返回 照片 的 过 程 ， 该 实例 
行 效果 如 图 5.5 所 示 。 

当 单 击 “ 启 动 摄像 头 ”按钮 时 ， 启 动 Android 系统 自 带 的 照相 机 应 用 程序 进行 拍照 ， 并 
将 拍摄 的 照片 显示 到 ImageView 组 件 中 。 
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图 5.5 CameraDemo 实例 运行 效果 


实例 CameraDemo 中 的 main.xml 代码 如 下 : 


<?xml version-"1.0" encoding-"utf-8"?» 
<LinearLayout 
xmlns:android-"http://schemas.android.com/apk/res/android" 
android:orientation-"vertical" 
android:layout width-"fill parent" 
android:layout height-"fill parent" 
> 


<Button 
android: id="@+id/button1" 
android:layout width-"match parent" 
android:layout height-"wrap content" 
android: text="@string/camera" /> 


<ImageView 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android: id="@+id/imageview" 
/> 
</LinearLayout> 


在 实例 cameraDemo 中 的 AndroidManifest.xml 代码 如 下 : 


<?xml version="1.0" encoding="utf-8"?> 
«manifest xmlns:android="http: //schemas.android. com/apk/res/android" 
package= "introduction. android.camera" 
android: versionCode="1" 
android: versionName="1.0"> 
<uses-sdk android:minSdkVersion="14" /> 


<application android:icon="@drawable/icon" 
android: label="@string/app_name"> 
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<activity android:name=".CameraDemoActivity" 
android: label="@string/app_name"> 
<intent-filter> 
<action android:name="android.intent.action.MAIN" /> 
<category 
android:name-"android.intent.category.LAUNCHER" /> 
</intent-filter> 
</activity> 
</application> 
«uses-permission android:name="android. permission. CAMERA" /> 
«uses-feature android:name="android. hardware. camera"/> 
</manifest> 


在 实例 cameraDemo 中 的 CameraDemoActivity.java 代码 如 下 : 
package introduction.android.camera; 


import android.app.Activity; 

import android.content.Intent; 

import android.graphics.Bitmap; 

import android.os.Bundle; 

import android.provider.MediaStore; 
import android.util.Log; 

import android.view.View; 

import android.view.View.OnClickListener; 
import android.widget.Button; 

import android.widget.ImageView; 


public class CameraDemoActivity extends Activity { 
/** Called when the activity is first created. */ 
private ImageView imageview; 
private Button btn; 
@Override 
public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState) ; 
setContentView (R.layout.main) ; 
imageview= (ImageView) findViewById (R.id.imageview) ; 
btn- (Button) findViewById (R.id.button1) ; 
btn.setOnClickListener (new OnClickListener() { 
public void onClick (View v) { 
// TODO Auto-generated method stub 
try{ 
Intent i=new Intent 
(MediaStore.ACTION_IMAGE_CAPTURE) ; 
startActivityForResult (i, 1) ; 
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catch (Exception e) { 
Log.d ("cameraDemo", e.toString()) ; 


protected void onActivityResult (int requestcode, int 
resultCode,Intent data) { 


try{ 
if (requestcode !=1) { 
return; 
} 
super.onActivityResult (requestcode, resultCode, data) ; 
Bundle extras=data.getExtras(); 
Bitmap bitmap= (Bitmap) extras.get ("data") ; 
imageview.setImageBitmap (bitmap) ; 
} 
catch (Exception e) { 
Log.d ("cameraDemo", e.toString()) ; 


) 
H 


在 启动 摄像 头 程序 时 ， 因 为 要 传 回 拍摄 的 图 像 ， 所 以 调用 了 Activity. startActivityForResult 
Intent intent, int requestCode) 方法 。 当 startActivityForResult( 方 法 启动 的 Activity 正常 结束 
时 ， 会 自动 返回 发 出 请 求 的 Activity ， 并 且 该 方法 会 返回 对 应 的 requestDode fii £i 
onActivityResult (int requestcode, int resultCode,Intent data) 方法 ， 借 此 可 以 在 请 求 Activity 和 
发 出 请 求 的 Activity 之 间 进 行 数据 传递 。 本 实例 借助 于 这 一 特点 传 回 了 Android 系统 照相 机 
程序 拍摄 的 照片 。 


3.3 小 结 


Intent 是 组 成 Android 应 用 程序 的 主要 组 成 部 分 之 一 。 借 助 于 Intent， 程 序 员 可 以 方便 地 
调用 Android 系统 中 的 其 他 应 用 程序 。 在 Intent 对 象 中 指定 程序 将 要 执行 的 动作 (Action) ， 
以 及 程序 执行 该 动作 时 所 需要 的 数据 (Data) ， 并 使 用 startActivity0 方 法 启动 该 Intent 对 
象 ，Android 系统 会 通过 intent-filter 属性 自动 寻找 符合 要 求 的 应 用 程序 并 执行 。 

本 章 简单 介绍 了 显 式 Intent 和 隐 式 Intent 的 使 用 方法 ， 并 举例 说 明了 使 用 Intent 调用 手机 
短信 和 拨号 程序 的 方法 ， 以 及 通过 startActivityForResult(0 方 法 调用 系统 摄像 头 应 用 程序 的 方 
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法 。 使 用 Intent 调用 手机 相关 功能 时 要 注意 要 在 AndroidManifest.xml 文件 中 注册 相应 的 权 
限 ，Android 系统 会 通过 intent-filter 属性 自动 寻找 符合 要 求 的 应 用 程序 并 执行 。 

借助 于 Intent， 程 序 员 可 以 方便 地 调用 Android 系统 中 的 其 他 应 用 程序 ， 例 如 启动 网 络 浏 
览 器 进行 网 上 冲浪 、 收 发 E-Mail 等 。 读 者 可 举一反三 ， 通 过 Intent 使 自己 开发 的 应 用 程序 更 
加 方便 和 强大 。 


5.6 思考 是 


1. Intent 可 调用 各 种 系统 功能 ， 如 访问 网 络 、 显 示 地 图 、 收 发 E-mail 等 ， 请 尝试 实现 。 
2. Intent 与 Intent Filter 的 匹配 规则 是 什么 ? 
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6 。 ] Service 


在 Android AZ, Service 不 是 一 个 单独 的 进程 ， 除 非特 殊 设 定 ， 否 则 它 不 会 单独 运行 
在 自己 的 进程 中 ， 通 常情 况 下 它 是 作为 启动 它 应 用 程序 的 一 部 分 与 当前 应 用 程序 运行 在 同一 
个 进程 中 。 


6.1.1 Service 的 作用 


服务 程序 Service 是 一 种 可 以 在 后 台 长 时 间 运 行 并 且 不 提供 用 户 UI 的 程序 。 即 使 启动 
Service 的 应 用 程序 被 切换 掉 ， 其 启动 的 Service 也 可 以 在 后 台 正 常 运行 。 因 此 Service 经 常 被 
用 来 处 理 一 些 耗 时 比较 长 的 程序 ， 例 如 进行 网 络 传输 或 是 播放 音乐 等 。 


6.1.2 Service 的 生命 周期 


Android 开发 中 ， 当 需要 创建 在 后 台 运 行 的 程序 的 时 候 ， 就 要 用 到 Service. Service 可 以 
分 为 有 无 限 生 命 和 有 限 生命 两 种 。 需 要 特别 注意 的 是 Service 跟 Activity 是 不 同 的 。 简 单 来 说 
可 以 理解 为 后 台 与 前 台 的 区 别 ，Activitty 拥有 UI， 可 以 与 用 户 交 互 ， 而 Service 则 不 能 。 当 
系统 资源 不 足 时 ，Activity 可 能 会 被 系统 销毁 以 释放 资源 ， 而 Service 不 会 。 

Service 类 中 定义 了 一 系列 和 自身 生命 周期 相关 的 方法 ， 在 此 不 一 一 介绍 ， 最 经 常 使 用 的 
有 以 下 三 个 方法 : 

© onCreate() 当 Service 第 一 次 被 创建 时 ， 系 统 调用 该 方法 。 

© onStartCommand ( Intent intentint flags,int startId ) 当 通 过 startService() 方 法 启动 

Service 时 ， 该 方法 被 调用 。 
© onDestroy()2i Service 不 再 使 用 时 ， 系 统 调 用 该 方法 。 


6.1.3 JAZ) Service 


要 启动 服务 程序 Service， 要 先 在 应 用 程序 的 AndroidManifest. XML 配置 文件 内 声明 
<service> 标 签 。 例 如 ， 如 果 建 立 了 一 个 ExampleService 的 Service， 就 要 在 配置 文件 中 添加 如 
下 代码 : 


«service android:name- *.ExampleService" /> 


此 外 <service> 标 签 可 用 含有 <intent-filter> 标 签 对 该 Service 进行 必要 的 说 明 。 
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启动 Service 有 两 种 方式 : Context.startService0 和 Context.bindService(): 


© public abstract void startService (Intent service) 。 其 中 参数 service 是 要 启动 的 服务 程 
序 名 称 

* public abstract boolean bindService ( Intent service,ServiceConnection conn,int flags ) : 
其 中 参数 service 是 定义 要 绑 定 的 服务 程序 名 称 ; conn 是 当 服务 程序 启动 和 停止 时 ， 
负责 接收 信息 的 接口 程序 ; flags 是 设置 绑 定 作业 的 选项 ， 可 以 是 0，BIND _ AUTO 
CREATE, BIND DEBUG UNBIND, BIND NOT FOREGROUND, BIND ABOVE _ 
CLIENT, BIND ALLOW OOM MANAGEMENT #4 BIND WAIVE PRIORITY, 


通过 startService0 来 启动 Service ， 该 方法 会 调用 Service 中 的 onCreate() 和 
onStartCommand() 方 法 来 启动 一 个 后 台 Service， 当 Service 销毁 时 直接 调用 onDestroy0 771A: 
通过 bindService() 方 法 启动 Service， 则 其 生命 周期 受 其 绑 定 对 象 控 制 。 一 个 Service 可 以 
同时 绑 定 到 多 个 对 象 上 ， 当 没有 任何 对 象 绑 定 到 Service 上 时 ， 该 Service 会 被 系统 销毁 。 
两 种 方式 对 Service 生命 周期 的 影响 如 图 6.1 所 示 。 


mn Lifetime 
| All clients unbind by calling | 
unbindService() 
The service is stopped | 
by itself or a client 
| E onUnbind() 


onDestroy() onDestroy() 


Unbounded Bounded 

图 6.1 两 种 方式 的 比较 
由 图 6.1 不 难看 出 ， 通 过 bindService() 方 法 启动 时 和 startService() 方 法 一 样 ， 都 会 调用 
onCreate() 方 法 来 创建 Service， 但 它 不 会 调用 onStartCommand() 方 法 而 是 调用 onBind0 返 回 客 
户 端 一 个 [Binder 接口 。 这 个 [Binder 就 是 在 Service 的 生命 周期 回调 方法 onBind0 中 的 返回 
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值 。 服 务 运行 后 ， 与 前 者 不 同 的 是 ， 不 是 服务 终止 ， 而 是 使 用 ContextunbindService() 方 法 之 
Ji, Service 的 生命 周期 回调 onUnbindO 会 被 调用 。 如 果 所 有 bind 过 Service 的 组 件 都 调用 
unbindService() 方 法 ， 那 么 之 后 Service 会 被 停止 ， 其 onDestroy0 回 调 会 被 调用 。 


BroadcastReceiver 


广播 (Broastcast) 是 Android 系统 中 应 用 程序 间 通 信 的 手段 。 当 有 特定 事件 发 生 时 ， 例 
如 有 来 电 、 有 短信 、 电 池 电 量变 化 等 事件 发 生 时 ，Android 系统 都 会 产生 特定 的 Intent 对 象 并 
且 自 动 进行 广播 ， 而 针对 特定 事件 注册 的 BroadcastReceiver 会 接收 到 这 些 广播 ， 并 获取 到 
Intent 对 象 中 的 数据 进行 处 理 。 在 广播 Intent 对 象 时 可 以 指定 用 户 权 限 ， 以 此 限制 仅 有 获得 了 
相应 权限 的 BroadcastReceiver 才能 接收 并 处 理 对 应 的 广播 。 

BroadcastReceiver 有 动态 和 静态 两 种 注册 方式 。 动 态 注册 方式 即使 用 Context. 
registerReceiver() 方 法 进行 注册 ， 需 要 特别 注意 的 是 ， 动 态 注册 方式 在 退出 程序 前 要 使 用 
Context.unregisterReceiver() 方 法 撤销 注册 。 静 态 注册 方法 即 在 AndroidManifest.xml. 文 件 中 通 
过 <receiver> 标 签 进行 注册 。 

-个 BroadcastReceiver 对 象 只 有 在 被 调用 onReceive (Context, Intent) 时 才 有 效 ， 当 从 
该 函数 返回 后 ， 该 对 象 就 已 无 效 了 ， 其 生命 周期 结束 。 
下 面 介绍 下 如 何 使 用 动态 注册 来 实现 监听 电池 剩余 电量 。 

实例 BatteryDemo 演示 了 使 用 动态 注册 BroadcastReceiver 对 象 并 且 接收 系统 电量 改变 事 

件 并 加 以 处 理 的 过 程 ， 运 行 效 果 如 图 6.2 所 示 。 


P" BatteryDemo 


检测 当前 手机 电量 


图 6.2 BatteryDemo 的 运行 效果 
实例 BatteryDemo 中 main.xml 的 代码 如 下 : 


<?xml version="1.0" encoding="utf-8"?> 
<LinearLayout 
xmlns:android-"http://schemas.android.com/apk/res/android" 
android:layout width-"fill parent" 
android:layout height-"fill parent" 
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<ToggleButton 
android: id="@+id/button" 
android:texton=" 检 测 当 前 手机 电量 " 
android:textoff=" 停 止 检测 " 
android:layout width-"fill parent" 
android:layout height-"wrap content" 
ES 


«TextView 
android:layout width-"fill parent" 
android:layout height-"wrap content" 
android: id="@+id/text"/> 


</LinearLayout> 


实例 BatteryDemo 中 AndroidMainfest.xml 的 代码 如 下 : 


<?xml version="1.0" encoding-"utf-8"?» 
«manifest xmlns:android="http://schemas.android.com/apk/res/android" 
package="introduction.android.batteryDemo" 
android: versionCode="1" 
android: versionName="1.0"> 
<uses-sdk android:minSdkVersion="14" /> 
<application 
android: icon="@drawable/ic_launcher" 
android: label="@string/app_name"> 
<activity 


android:name-"introduction.android.batteryDemo.BatteryDemoActivity" 
android: label="@string/app_name"> 
<intent-filter> 
<action android:name="android.intent.action.MAIN" /> 
<category 
android:name="android.intent.category. LAUNCHER" /> 
</intent-filter> 
</activity> 
</application> 
</manifest> 


实例 BatteryDemo 中 的 BatteryDemoActivity java 的 具体 实现 代码 如 下 : 
package introduction.android.batteryDemo; 


import introduction.android.batteryDemo.R; 
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import android.app.Activity; 

import android.content.BroadcastReceiver; 

import android.content.Context; 

import android.content.Intent; 

import android.content.IntentFilter; 

import android.os.Bundle; 

import android.widget.CompoundButton; 

import android.widget.CompoundButton.OnCheckedChangeListener; 
import android.widget.TextView; 

import android.widget.ToggleButton; 


public class BatteryDemoActivity extends Activity ( 
/** Called when the activity is first created. */ 
private ToggleButton button; 
private TextView text; 
BroadcastReceiver receiver-null; 


@Override 

public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState) ; 
setContentView (R.layout.main) ; 
button- (ToggleButton) findViewById (R.id.button) ; 
text- (TextView) findViewById (R.id.text) ; 


final BroadcastReceiver receiver-new BroadcastReceiver()( 


@Override 
public void onReceive (Context context, Intent intent) { 
// TODO Auto-generated method stub 
String action-intent.getAction(); 
if (Intent.ACTION BATTERY CHANGED.equals 
(action) ) { 
int current-intent.getExtras().getInt 
("level") ;// 获取 当前 电量 
int total-intent.getExtras().getInt 
("scale") ;// 获取 总 电量 
int value=current * 100 / total; 
text.setText ("当前 电量 是 "+value+"%"+"") ; 


u 
button.setOnCheckedChangeListener (new 
OnCheckedChangeListener () { 


public void onCheckedChanged (CompoundButton buttonView, 
boolean isChecked) { 
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// TODO Auto-generated method stub 
if (isChecked) { 
IntentFilter filter=new IntentFilter ( 


Intent .ACTION_BATTERY_CHANGED) ; 
registerReceiver (receiver, filter) ; 


} else { 
unregisterReceiver (receiver) ; 
text.setText ("") ; 


PE; 


其 中 ，Intent.ACTION_BATTERY_CHANGED 为 当 电池 电量 变化 时 产生 的 Intent 对 象 中 


携带 的 action 信息 。 


IntentFilter filter-new IntentFilter (Intent.ACTION BATTERY CHANGED) 


用 于 确定 当前 BroadcastReceiver 对 象 接收 的 Intent 对 象 的 类 型 。 
registerReceiver (receiver, filter) 动态 注册 receiver. 
int current=intent.getExtras().getInt ("level") ; 获取 当前 电池 的 电量 。 
int total=intent.getExtras().getInt ("scale") ; 获取 总 电量 。 
unregisterReceiver (receiver) ; 注销 receiver 注册 。 
该 应 用 程序 若 要 使 用 静态 注册 ， 则 需要 在 AndroidMainfest.xml 文件 中 添加 如 下 代码 : 
<receiver android:name="receiver"> 

<intent-filter> 

«action android:name-"android.intent.action.BATTERY CHANGED"/» 


«/intent-filter» 
«/receiver» 


音频 


Android 系统 支持 三 种 不 同 来 源 的 音频 的 播放 : 
COD 本 地 资源 
存储 在 应 用 程序 中 的 资源 ， 例 如 存储 在 RAW 文件 夹 下 的 媒体 文件 ， 只 能 被 当前 应 用 程 


序 访问 。 
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(2) 外 部 资源 

存储 在 文件 系统 中 的 标准 媒体 文件 ， 例 如 存储 在 SD 卡 中 的 文件 ， 可 以 被 所 有 应 用 程序 
访问 。 

(3) 网 络 资源 

通过 网 络 地 址 取得 的 数据 流 CURLO ， 例 如 “http://www.musiconline.com/classic/007. 
mp3”， 可 以 被 所 有 应 用 程序 访问 。 


6.3.1 Android4.0 支持 的 音频 格式 


Android 4.0 支持 的 音频 格式 如 表 6.1 所 示 。 
表 6.1 Android4.0 支持 的 音频 格式 


格式 / 编码 
AAC LC/LTP 
HE-AACVI (AAC+) IMPEG-4 (.mp4, .m4a) 


ADTS raw AAC (aac,decode in Android3.1+,encode in Android4.0+,ADIF 
HE-AACv2 (enhanced AAC+) [not supported) 
MPEG-TS (.ts.not seekable,Android3.0+) 


AMR-NB 3GPP (.3gp) 
AMR-WB 
FLAC 
MP3 


MIDI 


Vorbis 
Matroska (.mkv,Android4.0-- ) 


PCM/WAVE WAVE (.wav) 


6.3.2 ”音频 播放 器 


实例 MediaPlayerAudioDemo 演示 了 分 别 播放 三 种 类 型 的 资源 的 方法 。 该 实例 中 
MediaPlayerAudioActivity 向 Intent 对 象 中 传 入 要 载 入 的 资源 类 型 ， 并 通过 该 Intent 启动 用 于 
播放 音乐 的 Activity: PlayAudio. PlayAudio 根据 传 入 的 参数 分 别 获取 对 应 的 音乐 资源 并 且 播 


173 


Android 4.X 从 


| 精通 


放 。 实 例 MediaPlayerAudioDemo 运行 效果 如 图 6.3 所 示 。 


播放 存储 在 文件 系统 的 音乐 


图 6.3 MediaPlayerAudioDemo 的 运行 效果 
实例 MediaPlayerAudioDemo 中 的 main.xml 代码 如 下 : 


<?xml version="1.0" encoding="utf-8"?> 
<LinearLayout 
xmlns:android-"http://schemas.android.com/apk/res/android" 
android:orientation-"vertical" 
android:layout width-"fill parent" 
android:layout height-"fill parent" 
> 

<Button 
android:layout width-"fill parent" 
android:layout height-"wrap content" 
android: text=" HFE HER ABI TA" 
android: id="@+id/button0o1" 


EZ 

«Button 
android:layout width-"fill parent" 
android:layout height-"wrap content" 
android: text=" HAAB ig FA" 
android: id="@+id/button02" 


/> 

<Button 
android: layout_width="fill_ parent" 
android: layout_height="wrap_ content" 
android: text="4FK AM FINE" 
android: id="@+id/button03" 


J> 
</LinearLayout> 
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实例 MediaPlayerAudioDemo 中 MediaPlayerAudioActivity.java 文件 代码 如 下 : 


package introduction.android.mediaplayer; 


import android.app.Activity; 

import android.content.Intent; 

import android.os.Bundle; 

import android.view.View; 

import android.view.View.OnClickListener; 
import android.widget.Button; 


public class MediaPlayerAudioActivity extends Activity implements 
OnClickListener { 
/** Called when the activity is first created. */ 
private Button button01,button02,button03; 
private String  PLAY-"paly"; 
private int Local-1; 
private int Stream-2 ; 
private int Resources-3 ; 
@Override 
public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState) ; 
setContentView (R.layout.main) ; 
button01- (Button) findViewById (R.id.button01) ; 
button02- (Button) findViewById (R.id.button02) ; 
button03- (Button) findViewById (R.id.button03) ; 
button01.setOnClickListener (this) ; 
button02.setOnClickListener (this) ; 
button03.setOnClickListener (this) ; 
5 
@Override 
public void onClick (View v) { 
// TODO Auto-generated method stub 
Intent intent=new Intent 
(MediaPlayerAudioActivity.this,PlayAudio.class) ; 
if (v==button01) { 
intent.putExtra (PLAY, Local) ; 
} 
if (v==button02) { 
intent.putExtra (PLAY, Stream) ; 
} 
if (v==button03) { 
intent.putExtra (PLAY, Resources) ; 


} 
MediaPlayerAudioActivity .this.startActivity (intent) ; 
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实例 MediaPlayerAudioDemo 中 PlayAudio 类 实现 播放 音频 的 功能 ， 根 据 MediaPlayer- 
AudioActivity 类 通过 Intent 传递 过 来 的 值 的 不 同 ， 而 实现 三 种 不 同 的 播放 音频 的 方式 。 
PlayAudio.java 文件 的 代码 如 下 : 


package introduction.android.mediaplayer; 


import android.app.Activity; 
import android.media.MediaPlayer; 
import android.os.Bundle; 

import android.widget.TextView; 
import android.widget.Toast; 


public class PlayAudio extends Activity{ 
private TextView textview ; 
private String PLAY="paly"; 
private MediaPlayer mediaplayer; 
private String path ; 
GOverride 
public void onCreate (Bundle savedInstanceState) ( 
super.onCreate (savedInstanceState) ; 
setContentView (R.layout.other) ; 
textview- (TextView) findViewById (R.id.textview) ; 
Bundle extras-getIntent().getExtras(); 
playAudio (extras.getInt (PLAY) ) ; 
1 
private void playAudio (int play) { 
// TODO Auto-generated method stub 


try{ 

switch (play) { 

case 1: 
path="sdcard/music/white.mp3"; 
ii (path=—" "if 

Toast .makeText (PlayAudio.this, "在 SD 卡 中 未 找到 
音频 文件 "，Toast .LENGTH_LONG) ; 
} 
mediaplayer-new  MediaPlayer(); 
mediaplayer.setDataSource (path) ; 
mediaplayer.prepare(); 
mediaplayer.start(); 
textview.setText (" 正 在 播放 文件 中 的 音乐 ") ; 
break; 
case 2: 

path=" 
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http: //www.musiconline.com/classic/007.mp3"; 
if (path=="") { 
Toast.makeText (Playaudio.this，" 未 找到 您 要 播 
放 的 歌曲 "，Toast .LENGTH_LONG) .show() ; 
} 
mediaplayer=new MediaPlayer(); 
mediaplayer.setDataSource (path) ; 
mediaplayer.prepare(); 
mediaplayer.start(); 
textview.setText (" 正 在 播放 网 络 中 的 音乐 ") ; 
break ; 
case 3: 
mediaplayer=MediaPlayer.create (this, 
R.raw.black) ; 
mediaplayer.start(); 
textview.setText ("正在 播放 本 地 资源 中 的 音乐 "); 
break; 
} 


catch (Exception e) { 


System.out.println ("出 现 异常 ") ; 
} 


@Override 
protected void onDestroy() { 
// TODO Auto-generated method stub 
super.onDestroy(); 
if (mediaplayer !-null) 
{ 
mediaplayer.release(); 
mediaplayer-null ; 


} 


其 中 path 指向 要 播放 的 音频 文件 的 位 置 。 本 实例 中 ， 外 部 文件 系统 中 的 资源 是 放置 在 
SD 卡 中 的 music 目录 下 的 white.mp3; 网 络 资源 使 用 的 是 http:/Avww.musiconline.com/ 
classic/007.mp3; 本 地 资源 使 用 的 是 raw 目录 下 的 blackmp3 文件 。 

实例 MediaPlayerAudioDemo 中 AndroidManifest.xml 文件 的 代码 如 下 : 

<?xml version="1.0" encoding-"utf-8"?» 

«manifest xmlns:android="http: //schemas.android.com/apk/res/android" 


package="introduction.android.mediaplayer" 
android: versionCode="1" 
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android:versionName-"1.0"» 
«uses-sdk android:minSdkVersion-"10" /» 


«application android:icon-"edrawable/icon" 
android:label-"Gstring/app name"» 
«activity android:name-".MediaPlayerAudioActivity" 
android: label="@string/app_name"> 
<intent-filter> 
<action android:name="android.intent.action.MAIN" /> 
<category 
android:name="android.intent.category.LAUNCHER" /> 
</intent-filter> 
</activity> 
<activity android:name=".playAudio"></activity> 
</application> 
</manifest> 


在 该 实例 中 ， 每 次 播放 音频 文件 时 都 会 从 MediaPlayerAudioActivity 跳 转 到 一 个 新 的 
Activity， 即 PlayAudio。 当 返回 MediaPlayerAudioActivity 时 ， 由 于 PlayAudio 对 象 被 释放 
掉 ， 因 此 播放 的 音乐 也 随 之 停止 ， 不 再 播放 。 若 想 在 返回 MediaPlayerAudioActivity 时 音乐 也 
不 停止 ， 则 需要 使 用 Service 在 后 台 播 放 音 频 文件 。 


633 ”后 台 播 放 音 频 


实例 AudioServiceDemo 演示 了 如 何在 后 台 播放 音频 。 该 实例 运行 效果 如 图 6.4 所 示 。 当 
用 户 单 击 “ 启 动 Service” 按 钮 时 ， 当 前 Activity 结束 ， 应 用 程序 界面 消失 ， 返 回 Android 应 
用 程序 列表 ， 同 时 后 台 启 动 Service， 播 放 视频 文件 。 


P AudioServiceDemo 


启动 Service 


图 6.4 AudioServiceDemo 运行 效果 


该 实例 界面 简单 ， 仅 一 个 按钮 。 布 局 文件 main xml 代码 如 下 : 


<?xml version="1.0" encoding="utf-8"?> 
<LinearLayout 
xmlns:android-"http://schemas.android.com/apk/res/android" 
android:layout width-"fill parent" 
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android:layout height-"fill parent" 
android:orientation="vertical"> 
<Button 
android: id="@+id/button1" 
android: layout_width="fill_parent" 
android: layout_height="wrap_content" 
android: text="j4z) Service " /> 
</LinearLayout> 


实例 AudioServiceDemo 中 的 Activity 文件 AudioServiceDemoActivity.java 代码 如 下 : 


package introduction.android.AudioServiceDemo; 


import android.app.Activity; 
import android.content.Intent; 
import android.os.Bundle; 
import android.view.View; 
import android.widget.Button; 


public class AudioServiceDemoActivity extends Activity ( 
/** Called when the activity is first created. */ 
private Button btn; 

GOverride 

public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState) ; 
setContentView (R.layout.main) ; 
btn- (Button) findViewById (R.id.buttonl) ; 
btn.setOnClickListener (new View.OnClickListener()( 


@Override 
public void onClick (View v) { 
// TODO Auto-generated method stub 
startService (new Intent 
("introduction.android.AudioServiceDemo.MY AUDIO SERVICE") ) ; 
finish(); 


AudioServiceDemoActivity 在 按钮 被 单 击 后 使 用 startService() 方 法 启动 了 自 定义 的 服务 
MY AUDIO_ SERVICE， 然 后 调用 finish0 方 法 关闭 当前 Activity。 该 服务 需要 在 AndroidManifest. 
xml 文件 中 进行 声明 。AndroidManifestxml 代码 如 下 : 


<?xml version-"1.0" encoding-"utf-8"?» 
«manifest xmlns:android-"http://schemas.android.com/apk/res/android" 


179 


oid 4.X 从 


package-"introduction.android.AudioServiceDemo" 
android:versionCode-"1" 
android:versionName-"1.0"» 


«uses-sdk android:minSdkVersion="14" /» 
«application android:icon-"Gdrawable/ic launcher" 
android:label-"Gstring/app name"» 


«activity android:name-".AudioServiceDemoActivity" 
android: label="@string/app_name"> 
<intent-filter> 
«action android:name="android. intent .action.MAIN"/> 
<category 
android:name="android.intent.category. LAUNCHER" /> 
</intent-filter> 
</activity> 
<service android:name="MyAudioService"> 
<intent-filter> 
<action 
android:name="introduction.android.AudioServiceDemo.MY_AUDIO_SERVICE"/> 
<category 
android:name="android.intent.category.DEFAULT" /> 
</intent-filter> 
</service> 
</application> 


</manifest> 
其 中 ， 
<service android:name="MyAudioService"> 
<intent-filter> 
<action 
android:name-"introduction.android.AudioServiceDemo.MY AUDIO SERVICE"/» 
«category 
android:name-"android.intent.category.DEFAULT"/» 


</intent-filter> 
</service> 


定义 了 名 为 MyAudioService 的 Service, 1% Service X] 4479 "introduction android. AudioServiceDemo. 


MY AUDIO SERVICE" [i] z/ EET] Ab FE. 
实例 AudioServiceDemo 中 的 MyAudioService.java 代码 如 下 : 


package introduction.android.AudioServiceDemo; 


import java.io. IOException; 


180 


第 6 章 多 媒体 开发 


import android.app.Service; 
import android.content.Intent; 
import android.media.MediaPlayer; 
import android.os.IBinder; 


public class MyAudioService extends Service { 


private MediaPlayer mediaplayer; 
@Override 
public IBinder onBind (Intent arg0) ( 
// TODO Auto-generated method stub 
return null; 


GOverride 
public void onDestroy()( 
// TODO Auto-generated method stub 
super.onDestroy(); 
if (mediaplayer !-null) 
t 
mediaplayer.release(); 
mediaplayer-null ; 


GOverride 
public void onStartCommand (Intent intent,int flags,int startId) { 
// TODO Auto-generated method stub 
super.onStartCommand (intent, flags, startId) ; 
String path="sdcard/music/white.mp3"; 
mediaplayer-new MediaPlayer(); 


try ( 
mediaplayer.setDataSource (path) ; 


mediaplayer.prepare(); 
mediaplayer.start(); 

}catch (IOException e) { 
// TODO Auto-generated catch block 
e.printStackTrace() ; 


该 服务 启动 Mediaplayer， 并 播放 存放 于 SD 卡 中 的 “sdcard/music/white.mp3” 文 件 。 
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6.3.4 ”录音 程序 


Android SDK 提供 了 使 用 MediaRecorder 类 实现 对 音频 和 视频 进行 录制 的 功能 。 
MediaRecorder 对 象 在 运行 过 程 中 存在 多 种 状态 ， 其 状态 转化 如 图 6.5 所 示 。 


Error occurs or EN 


an invalid call setAudioSource()/ 
etVideoSource() 


etAudioSource()/ 
setVideoSource() 


setVideoEncoder() 
setOutputFileQ) 
setVideoSize) 
setVideoFrameRate() 
setPreviewDisplay 


6.5 MediaRecorder 对 象 状 态 转化 图 


从 图 6.5 中 可 以 看 到 : 

(1) 创建 MediaRecorder 对 象 后 处 于 Initial 状态 ，MediaRecorder 对 象 会 占用 硬件 资源 ， 
因此 在 不 再 需要 时 ， 应 该 调用 release0 方 法 销毁 。 在 其 他 状态 调用 reset0 方 法 ， 可 以 使 得 
MediaRecorder 对 象 重新 回 到 Initial 状态 ， 达 到 复 用 MediaRecorder 对 象 的 目的 。 

(2) 在 Initial 状态 调用 setVideoSource0) 或 者 setAudioSource()Z Ja, MediaRecorder 将 进 
入 Initialized 状态 。 对 于 音频 录制 ， 目 前 OPhone 平台 支持 从 麦克 风 或 者 电话 两 个 音频 源 录制 
数据 。 在 Initialized 状态 的 MediaRecorder 还 需要 设置 编码 格式 、 文 件数 据 路 径 、 文 件 格式 等 
信息 ， 设 置 之 后 MediaRecorder 进入 到 DataSourceConfigured 状态 。 

(3) 在 DataSourceConfigured 状态 调用 prepare0 方 法 ，MediaRecorder 对 象 将 进入 Prepared 
状态 ， 录 制 前 的 状态 准备 就 绪 。 

(4) 在 Prepared 状态 调用 start0 方 法 ，MediaRecorder 进入 Recording 状态 ， 声 音 录 制 可 
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能 只 需 一 段 时 间 ， 这 时 MediaRecorder 一 直 处 于 录制 状态 。 


C5) 在 Recording 状态 调用 stop0 方 法 ，MediaRecorder 将 停止 录制 ， 并 将 录制 内 容 输出 
到 指定 文件 。 

MediaRecorder 定义 了 两 个 内 部 接口 OnErrorListener 和 OnInfoListener 来 监听 录制 过 程 中 
的 错误 信息 。 例 如 ， 当 录制 的 时 间 长 度 达到 了 最 大 限制 或 者 录制 文件 的 大 小 达到 了 最 大 文件 
限制 时 ， 系 统 会 回调 已 经 注册 的 OnInfoListener 接口 的 onInfo0 方 法 。 

使 用 MediaRecorder 类 进行 音频 录制 的 基本 步骤 如 下 : 

人 OO) 建立 MediaRecorder 类 的 对 象 。 
MediaRecorder recorder-new MediaRecorder(); 
GI 设置 音频 来 源 。 

recorder.setAudioSource (MediaRecorder.AudioSource.MIC) ; 
CX 设置 音频 输出 格式 。 

recorder.setOutputFormat (MediaRecorder.OutputFormat.THREE_GPP) ; 
ED 设置 音频 编码 方式 。 

recorder.setAudioEncoder (MediaRecorder.AudioEncoder.AMR_NB) ; 
EE 设置 音频 文件 的 保存 位 置 及 文件 名 。 

recorder.setOutputFile (PATH NAME) ; 

Gs 将 录音 器 置 于 准备 状态 。 
recorder.prepare(); 

€» 启动 录音 器 。 
recorder.start(); 

Elles dd. 

EIo A84) A, HERTS. 
recorder.stop(); 

Io 释放 录音 器 对 象 。 
recorder.release(); 

实例 AudioRecord 演示 了 使 用 MediaRecorder 类 对 音频 进行 录制 的 过 程 ， 运 行 效果 如 图 
6.6 所 示 。 
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P AudioRecordDemo 


录音 Demo 


回 [us 


开始 录音 停止 录音 


图 6.6 AudioRecord 的 运行 效果 


该 运行 效果 对 应 的 布局 文件 main.xml 的 代码 如 下 : 


<?xml version="1.0" encoding="utf-8"?> 
<LinearLayout 
xmlns:android-"http://schemas.android.com/apk/res/android" 
android:layout width-"fill parent" 
android:layout height-"fill parent" 
android:orientation-"vertical"» 


«TextView 
android:layout width-"fill parent" 
android:layout height-"wrap content" 
android:layout marginLeft-"70dp" 
android:layout marginTop-"30dp" 
android:text-"Gstring/hello" /» 


«LinearLayout 
android:layout width-"fill parent" 
android:layout height-"wrap content" 
android:layout marginTop-"30dp" 
android: orientation="horizontal"> 


<ImageButton 
android: id="@+id/st" 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android: layout_marginLeft="20dp" 
android:scaleType="fitxy" 
android:src="@drawable/st" /> 


<ImageButton 


android: id="@+id/stop" 
android: layout_width="wrap_content" 
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android: layout_height="wrap_content" 
android: layout_marginLeft="30dp" 
android: scaleType="fitxy" 
android:src="@drawable/stop" /> 


</LinearLayout> 
<LinearLayout 
android:layout width-"fill parent" 
android:layout height-"wrap content" 
android:orientation-"horizontal"» 


«TextView 
android:layout marginLeft-"21dp" 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:text="@string/start" /> 
<TextView 
android: layout_marginLeft="43dp" 
android: layout_width="wrap_content" 
android:layout height-"wrap content" 
android:text-"Gstring/stop" /» 


«/LinearLayout» 
«TextView 
android: id="@+id/sttext" 
android: layout_width="fill_parent" 
android: layout_height="wrap_content" 
/> 
</LinearLayout> 


实例 AudioRecord 中 的 AndroidManifest.xml 文件 代码 如 下 : 


<?xml version="1.0" encoding-"utf-8"?» 

«manifest xmlns:android-"http://schemas.android.com/apk/res/android" 
package-"introduction.android.AudioRecord" 
android:versionCode-"'1" 
android:versionName-"'1.0"» 


«uses-sdk android:minSdkVersion="14" /> 
<uses-permission android:name="android.permission.RECORD_AUDIO"/> 
<application 
android: icon="@drawable/ic_launcher" 
android: label="@string/app_name"> 
<activity 
android:name-".AudioRecordDemo" 
android: label="@string/app_name"> 
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<intent-filter> 
<action android:name="android.intent.action.MAIN" /> 
«category android:name="android. intent .category . LAUNCHER" 


/> 


</intent-filter> 
</activity> 
</application> 


</manifest> 


其 中 ， 


<uses-permission android:name="android.permission.RECORD_AUDIO"/> 


表明 进行 音频 录制 的 用 户 权限 。 
实例 AudioRecord 中 AudioRecordDemo java 的 代码 如 下 : 


package introduction.android.AudioRecord; 


import java.io.File; 
import java.io.IOException; 


import introduction.AudioRecord.audioRecorder.R; 


import android.app.Activity; 

import android.media.MediaRecorder; 
import android.os.Bundle; 

import android.os.Environment; 

import android.util.Log; 

import android.view.View; 

import android.view.View.OnClickListener; 
import android.widget.ImageButton; 

import android.widget.TextView; 

import android.widget.Toast; 


public class AudioRecordDemo extends Activity implements 
OnClickListener ( 
/** Called when the activity is first created. */ 
private ImageButton st,stop; 
private TextView sttext; 
private MediaRecorder mRecorder; 
private File recordPath; 
private File recordFile; 
@Override 
public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState) ; 
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setContentView (R.layout.main) ; 


st- (ImageButton) findViewById (R.id.st) ; 
stop= (ImageButton) findViewById (R.id.stop) ; 
sttext= (TextView) findViewById (R.id.sttext) ; 
st.setOnClickListener (this) ; 
stop.setOnClickListener (this) ; 
} 
public void start(){ 
if (checkSDCard()) ( 
recordPath-Environment.getExternalStorageDirectory(); 
File path=new File (recordPath.getPath()+File.separator 
+"audioRecords") ; 
if (!path.mkdirs()) ( 
Log.d ("audioRecorder", "创建 目录 失败 ") ; 
return; 
} 
} else { 
Toast.makeText (AudioRecordDemo.this, "SDcard 未 连接 "， 
Toast.LENGTH LONG) .show(); 
return ; 


try ( 
recordFile-File.createTempFile (String.valueOf ("myrecord "), 
".amr", recordPath) ; 
} catch (IOException e) { 
Log.d ("audioRecorder", "文件 创建 失败 ") ; 


mRecorder=new MediaRecorder(); 

// 设置 麦克 风 

mRecorder.setAudioSource (MediaRecorder.AudioSource.MIC) ; 

// 输出 文件 格式 

mRecorder.setOutputFormat (MediaRecorder.OutputFormat.DEFAULT) ; 


// 音频 文件 编码 
mRecorder.setAudioEncoder (MediaRecorder.AudioEncoder.DEFAULT) ; 


// 输出 文件 路 径 
mRecorder.setOutputFile (recordFile.getAbsolutePath()) ; 


// 开始 录音 

try { 
mRecorder.prepare(); 
mRecorder.start(); 

} catch (IllegalStateException e) { 
e.printStackTrace(); 
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} catch (IOException e) { 
e.printStackTrace(); 


public void stop() { 
try{ 
if (mRecorder !=null) { 
mRecorder.stop(); 
mRecorder.release(); 
mRecorder-null; 
} 
} 
catch (IllegalStateException e) { 


private boolean checkSDCard() { 
// TODO Auto-generated method stub 
// 检 测 SD 卡 是 否 插入 到 手机 中 
if (android.os.Environment.getExternalStorageState().equals 
(android.os.Environment.MEDIA MOUNTED) ) 
t 
return true; 
} 
return false; 
} 
@Override 
public void onClick (View v) { 


// TODO Auto-generated method stub 
i£ (v==st) { 


AudioRecordDemo.this.start(); 


sttext.setText ("正在 录音 。。。。。。"); 
} 


if (v==stop) { 


sttext.setText ("Jib 4. oo o oo "2 5; 
AudioRecordDemo.this.stop(); 


} 


该 应 用 程序 运行 后 ， 首 先 检 测 SD 卡 是 否 插入 在 手机 中 。 若 SD 卡 在 手机 中 ， 则 会 在 SD 
卡 的 audioRecords 目录 下 创建 以 “myRecord_ ”为 前 级 ， 以 “.amr” 为 后 级 的 临时 文件 ， 并 将 
录音 内 容 写 入 到 该 文件 中 。 
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635 ”后台 录制 音频 


结合 Android 系统 提供 的 相关 API， 借 助 于 MediaRecorder 类 ， 可 以 实现 一 些 比较 有 意思 
的 功能 。 比 如 ， 可 以 在 手机 中 监听 短信 功能 ， 当 有 符合 特定 要 求 的 短信 到 来 时 ， 启 动 相应 服 
务 在 后 台 进 行 录音 ， 进 而 将 手机 变化 为 一 个 可 远程 控制 的 录音 机 。 

本 文 在 此 处 不 去 实现 短信 内 容 验 证 功能 ， 而 只 演示 通过 短信 远程 启动 后 台 服 务 并 进行 录 
音 的 功能 ， 读 者 可 以 举一反三 。 

实例 AudioRecordService 演示 了 该 功能 。 该 实例 实现 了 BroadcastReceiver 类 的 子 类 ， 对 
手机 短信 息 进 行 监听 。 当 有 短信 来 时 ， 该 BroadcastReceiver 开始 在 后 台 录 音 并 将 录音 文件 保 
存在 SD 卡 中 ， 同 时 启动 一 个 线程 进行 计时 ， 当 录音 进行 一 分 钟 后 ， 关 闭 录 音程 序 。 

实例 AudioRecordService 中 MessageReceiverjava 代码 如 下 : 


package introduction.android.audioServiceRecord; 


import java.io.File; 
import java.io. IOException; 


import android.content.BroadcastReceiver; 
import android.content.Context; 

import android.content.Intent; 

import android.media.MediaRecorder; 
import android.os.Bundle; 

import android.os.Environment; 

import android.util.Log; 


public class MessageReceiver extends BroadcastReceiver ( 
private File recordPath; 
private File recordFile; 
private MediaRecorder mRecorder; 
private long startTime; 
@Override 
public void onReceive (Context context, Intent intent) { 
// TODO Auto-generated method stub 
if (intent.getAction() .equals 
("android.proider.Telephony.SMS_RECEIVER") ) 
{ 
recordBegin(); 
new Thread (timing) .start(); 


i 


private Runnable timing-new Runnable() { 
private long currentTime=System.currentTimeMillis(); 
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@Override 


public void run()( 
// TODO Auto-generated method stub 
while (currentTime<startTime+60*1000) { 


try { 
Thread.sleep (1000) ; 

} catch (InterruptedException e) { 
// TODO Auto-generated catch block 
e.printStackTrace(); 


y 
recordStop(); 


}; 


private void recordBegin(){ 
// TODO Auto-generated method stub 
startTime=System.currentTimeMillis(); 
recordPath-Environment.getExternalStorageDirectory(); 
File path=new File (recordPath.getPath()+File.separator 
*"audioRecords") ; 


recordPath-path; 
try ( 


recordFile-File.createTempFile (String.valueOf ("myrecord "), 


".amr", recordPath) ; 
} catch (IOException e) { 
Log.d ("audioRecorder", "文件 创建 失败 ") ; 


mRecorder-new MediaRecorder(); 

mRecorder.setAudioSource (MediaRecorder.AudioSource.MIC) ; 

mRecorder.setOutputFormat 
(MediaRecorder.OutputFormat.DEFAULT) ; 

mRecorder.setAudioEncoder 


(MediaRecorder.AudioEncoder.DEFAULT) ; 
mRecorder.setOutputFile (recordFile.getAbsolutePath()) ; 


try ( 
mRecorder.prepare(); 
mRecorder.start(); 

} catch (IllegalStateException e) { 
e.printStackTrace(); 

} catch (IOException e) { 
e.printStackTrace(); 


b 
protected void recordStop() { 
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// TODO Auto-generated method stub 
mRecorder.stop(); 
mRecorder.release(); 
mRecorder-null; 


由 于 实例 AudioRecordService 涉及 接收 短信 和 使 用 录音 功能 ， 因 此 需要 在 AndroidManifest. 
xml 文件 中 声明 相应 的 用 户 权限 。AndroidManifestxml 文件 代码 如 下 : 


<?xml version="1.0" encoding-"utf-8"?» 

«manifest xmlns:android-"http://schemas.android.com/apk/res/android" 
package-"introduction.android.audioServiceRecord" 
android:versionCode-"1" 
android: versionName="1.0"> 

<uses-sdk android:minSdkVersion="14" /> 
<application 
android:icon-"Gdrawable/ic launcher" 
android: label="@string/app_name"> 
<receiver android:name="MessageReceiver"> 
<intent-filter> 
<action 
android:name-"android.provider.Telephony.SMS RECEIVED"/» 
</intent-filter> 
</receiver> 
</application> 

<uses-permission android:name="android.permission.RECEIVE_SMS"> 

</uses-permission> 

<uses-permission android:name="android.permission.RECORD_AUDIO"> 

</uses-permission> 

</manifest> 


6.4.1 Android4.0 支持 的 视频 文件 
Android 4.0 支 持 的 视频 格式 如 表 6.2 所 示 。 
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表 6.2 Android4.0 支持 的 视频 文件 


格式 / 编码 支持 的 文件 类 型 
H.263 3GPP (.3gp) ; MPEG-4 (.mp4) 


3GPP (.3gp) ; MPEG-4 Cmp4) 


H.264 AVC 

MPEG-TS (.ts, AAC audio only, not seekable, Android 3.0+) 
|MPEG-4 SP 3GPP (.3gp) 
'VP8 WebM (.webm) ; Matroska (.mkv, Android 4.0+) 


6.4.2 ”视频 播放 器 


与 音频 播放 相 比 ， 视 频 的 播放 需要 使 用 视觉 组 件 将 影像 显示 出 来 。 在 Android SDK 中 提 
供 了 多 种 播放 视频 文件 的 方法 。 例 如 可 以 用 VideoView 或 SurfaceView 来 播放 视频 ， 其 中 使 
用 VideoView 组 件 播放 视频 最 为 方便 。 

实例 VideoPlayDemo 演示 了 使 用 android.widget.VideoView 组 件 进行 视频 播放 的 方法 ， 运 
行 效果 如 图 6.7 所 示 。 


'MediaPlayerVudiodemo 


图 6.7 VideoPlayDemo 运行 效果 


实例 VideoPlayDemo 中 含有 两 个 Activity， 其 中 PlayVideo 含有 VideoView 组 件 对 象 ， 用 
于 播放 视频 。 视 频 文件 存放 在 SD 卡 中 ， 路 径 为 “Movies/movie.3gp”。 而 VideoPlayAcitvity 
为 主 Activity， 用 于 启动 PlayVideo。 

实例 VideoPlayDemo 中 VideoPlayActivity.java 代码 如 下 : 


package introduction.android.playvideo; 
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import introduction.android.playvideo.R; 
import android.app.Activity; 

import android.content.Intent; 

import android.os.Bundle; 


import android.view.View; 
import android.view.View.OnClickListener; 
import android.widget.Button; 


public class VideoPlayAcitvity extends Activity { 
/** Called when the activity is first created. */ 
private Button button01; 


GOverride 

public void onCreate (Bundle savedInstanceState) ( 
super.onCreate (savedInstanceState) ; 
setContentView (R.layout.main) ; 
button01- (Button) findViewById (R.id.button01) ; 
button01.setOnClickListener (new buttonListener()) ; 


class buttonListener implements OnClickListener ( 


@Override 
public void onClick (View v) { 
// TODO Auto-generated method stub 
Intent intent=new Intent (VideoPlayAcitvity.this, 
PlayVideo.class) ; 
VideoPlayAcitvity.this.startActivity (intent) ; 


j 


实例 VideoPlayDemo 中 PlayVideo.java 代码 如 下 : 


package introduction.android.playvideo; 
import introduction.android.playvideo.R; 
import android.app.Activity; 

import android.net.Uri; 

import android.os.Bundle; 

import android.widget .MediaController; 
import android.widget.Toast; 

import android.widget.VideoView; 


public class PlayVideo extends Activity { 
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private VideoView videoView; 
private MediaController mc ; 
private String path ; 


@Override 
public void onCreate (Bundle savedInstanceState) { 


super.onCreate (savedInstanceState) ; 

setContentView (R.layout.other) ; 

videoView- (VideoView) this. findViewById (R.id.videoView) ; 

path="sdcard/Movies/movie.3gp"; 

mc=new MediaController (this) ; 

videoView.setMediaController (mc) ; 

videoView.setVideoPath (path) ; 
videoView.setOnCompletionListener (new OnCompletionListener () { 


@Override 
public void onCompletion (MediaPlayer arg0) { 


// TODO Auto-generated method stub 
finish(); 
} 
DE 
videoView.requestFocus(); 
videoView.start(); 


} 

其 中 MediaController 类 为 Android SDK 提供 的 视频 控制 器 ， 用 于 显示 播放 时 间 ， 对 播放 
视频 进行 控制 。 通 过 VideoView 类 的 setMediaController0 方 法 可 以 将 视频 控制 器 和 Video View 
类 结合 在 一 起 ， 对 VideoView 中 播放 的 视频 进行 控制 ， 大 大 降低 了 编码 强度 。 由 于 要 播放 的 
视频 为 放置 在 SD 卡 中 的 “Movies/movie.3gp” 文 件 ，VideoView 组 件 使 用 setVideoPath() 方 法 
即 可 指定 该 文件 ， 并 通过 start() 方 法 进行 播放 。 

videoView.setOnCompletionListener (new OnCompletionListener(){ 


@Override 
public void onCompletion (MediaPlayer arg0) { 


// TODO Auto-generated method stub 
finish(); 


2; 


这 行 代码 指定 了 videoView 组 件 的 视频 播放 完成 事件 的 触发 器 ， 当 视频 播放 完成 后 ， 关 
闭 当 前 Activity. 

PlayVideo 使 用 的 布局 为 R.layout.other， 该 布局 中 含有 VideoView 组 件 ， 其 所 对 应 的 xml 
文件 other.xml 代码 如 下 : 


<?xml version="1.0" encoding="utf-8"?> 
<LinearLayout 
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xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android: layout_width="fill_parent" 
android:layout height-"fill parent" 
> 
<VideoView 
android: id="@+id/videoView" 
android: layout_width="320px" 
android: layout_height="240px" 
/> 
</LinearLayout> 


实例 VideoPlayDemo 中 的 AndroidManifest.xml 文件 代码 如 下 : 


<?xml version="1.0" encoding="utf-8"?> 
«manifest xmlns:android-"http://schemas.android.com/apk/res/android" 
package="introduction.android.playvideo" 
android: versionCode="1" 
android: versionName="1.0"> 
<uses-sdk android:minSdkVersion="10" /> 


«application android: icon="@drawable/icon" 
android: label="@string/app_name"> 
<activity android:name=".VideoPlayAcitvity" 
android: label="@string/app_name"> 
<intent-filter> 
<action android:name="android.intent.action.MAIN" /> 
<category 
android:name="android.intent.category. LAUNCHER" /> 
</intent-filter> 
</activity> 
<activity 
android:name-"introduction.android.playvideo.PlayVideo"»«/activity» 


«/application» 
«/manifest» 


此 外 ，VideoView 也 支持 网 络 流 媒 体 的 播放 ， 只 需 将 VideoView 的 setVideoPath() 7j 14: £F 
换 为 setViewURIO， 并 指定 对 应 的 Uri 即 可 。 需 要 注意 的 是 ， 并 不 是 所 有 的 mp4 和 3gp 文件 
都 可 以 被 VideoView 组 件 播放 ， 只 有 使 用 progressive streamable 模式 转化 的 影片 才 可 以 被 播 
放 。 播 放 网 络 流 媒 体 文件 时 ， 需 要 在 AndroidManifest.xml 文件 中 添加 相应 权限 : 


<uses-permission android:name="android.permission.INTERNET"/> 
<uses-permission android:name="android.permission.WAKE LOCK"/> 


其 中 android.permission.INTERNET 权限 使 当前 应 用 程序 可 以 访问 网 络 资源 ， 
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android permission. WAKE LOCK 权限 使 当前 应 用 程序 运行 时 ， 手 机 不 会 进入 休眠 状态 ， 以 便 
于 视频 播放 。 

使 用 SurfaceView 组 件 播放 视频 的 方法 也 不 复杂 ， 而 且 更 加 灵活 。 实 例 MediaPlayerVideoDemo 
演示 了 使 用 SurfaceView 和 MediaPlayer 组 件 播放 视频 的 方法 ， 运 行 效果 如 图 6.8 所 示 。 


P MediaPlayerVideoDemo 


播放 暂停 mW mu 


图 6.8 MediaPlayerVideoDemo 的 运行 效果 
对 应 的 布局 文件 main.xml 内 容 如 下 : 


<?xml version-"1.0" encoding-"utf-8"?» 
«LinearLayout 
xmlns:android-"http://schemas.android.com/apk/res/android" 
android:layout width-"fill parent" 
android:layout height-"fill parent" 
android:orientation-"vertical"» 


«SurfaceView 
android: id="@+id/surfaceView1" 
android:layout width-"fill parent" 
android:layout height-"wrap content" 
android:layout weight-"1.01" /» 


«LinearLayout 
android: id="@+id/linearLayout1" 
android:layout width-"match parent" 
android:layout height-"wrap content" android:gravity="center"> 


«Button 
android: id="@+id/button1" 
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android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:text-"jf7(" /> 


«Button 
android: id="@+id/button2" 
android: layout_width="wrap_ content" 
android:layout height-"wrap content" 
android:text-"Z/fj" /> 


«Button 
android: id="@+id/button3" 
android: layout_width="wrap content" 
android:layout height-"wrap content" 
android:text- "Zi" /> 


«Button 
android: id="@+id/button4" 
android: layout_width="wrap content" 
android:layout height-"wrap content" 
android:text-"/Z;jL" /> 


«/LinearLayout» 
</LinearLayout> 


实例 MediaPlayer VideoDemo 的 配置 文件 AndroidManifest.xml 内 容 如 下 : 


<?xml version-"1.0" encoding-"utf-8"?» 

«manifest xmlns:android-"http://schemas.android.com/apk/res/android" 
package-"introduction.android.videoPlayDemo" 
android:versionCode-"1" 
android:versionName-"1.0"» 

«uses-sdk android:minSdkVersion-"14" /> 
«application 
android:icon-"edrawable/ic launcher" 
android: label="@string/app_name"> 
<activity 
android: label="@string/app_ name" 
android:name=".VideoPlayDemoActivity"> 
<intent-filter> 
<action android:name="android.intent.action.MAIN" /> 


<category 
android:name="android. intent .category.LAUNCHER" /> 
</intent-filter> 
</activity> 
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</application> 
</manifest> 


实例 MediaPlayerVideoDemo 中 的 主 Activity 文件 VideoPlayDemoActivity.Java 代码 如 下 : 


package introduction.android.videoPlayDemo; 


import java.io. IOException; 

import android.app.Activity; 
import android.media.AudioManager; 
import android.media.MediaPlayer; 
import android.os.Bundle; 

import android.util.Log; 

import android.view.SurfaceHolder; 
import android.view.SurfaceView; 
import android.view.View; 

import android.view.View.OnClickListener; 
import android.widget.Button; 


public class VideoPlayDemoActivity extends Activity ( 
/** Called when the activity is first created. */ 
private Button playbtn; 
private Button pausebtn; 
private Button replaybtn; 
private Button stopbtn; 
private SurfaceView surview; 
private SurfaceHolder surHolder; 
private MediaPlayer mp; 
private String path-"sdcard/movies/movie.3gp"; 
protected boolean pause-false; 
@Override 
public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState) ; 
setContentView (R.layout.main) ; 
surview= (SurfaceView) this. findViewById (R.id.surfaceView1) 
surHolder-surview.getHolder(); 
surHolder.setType (SurfaceHolder.SURFACE TYPE PUSH BUFFERS) ; 
mp-new MediaPlayer(); 
mp.setOnCompletionListener (new 
MediaPlayer .OnCompletionListener () { 


@override 

public void onCompletion (MediaPlayer mp) { 
// TODO Auto-generated method stub 
Log.i ("mediaplayer", "播放 完成 ") ; 


198 


第 6 章 多 媒体 开发 
291 


playbtn- (Button) this.findViewById (R.id.buttonl) ; 
playbtn.setOnClickListener (new OnClickListener()( 


GOverride 
public void onClick (View arg0) ( 
// TODO Auto-generated method stub 
if (!pause) ( 
// 开 始 播放 
mp.setAudioStreamType 
(AudioManager.STREAM_MUSIC) ; 
mp.setDisplay (surHolder) ; 
try { 
mp.setDataSource (path) ; 
mp.prepare(); 
mp.start(); 
) catch (IOException e) ( 
// TODO Auto-generated catch block 
e.printStackTrace(); 
} 
jelse{ 
// 暂 停 播放 
mp.start(); 
pause=false; 


0: 
pausebtn- (Button) this.findViewById (R.id.button2) ; 
pausebtn.setOnClickListener (new OnClickListener()( 
// 暂 停 播放 
@Override 
public void onClick (View arg0) { 
// TODO Auto-generated method stub 
if (mp!=null) { 
pause=true; 
mp.pause(); 


2; 
replaybtn- (Button) this.findViewById (R.id.button3) ; 
replaybtn.setOnClickListener (new OnClickListener()( 
// 重 新 播放 
@override 
public void onClick (View argO) { 
// TODO Auto-generated method stub 
if (mp!=null) { 
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mp.seekTo (0) ; 


} 
Dr 
stopbtn= (Button) this.findViewById (R.id.button4) ; 
stopbtn.setOnClickListener (new OnClickListener () { 
// 停 止 播放 
@Override 
public void onClick (View arg0) { 
// TODO Auto-generated method stub 
if (mp!=null) { 


mp.stop(); 
mp.release(); 


6.43 ”拍照 程序 


在 之 前 的 章节 中 有 过 拍照 程序 ， 是 通过 Intent 调用 了 Android 系统 提供 的 照相 机 程序 进 
行 实现 的 。 其 实 Android SDK 提供 了 直接 操作 移动 设备 摄像 头 的 android.hardware.Camera 
类 ， 通 过 该 类 的 相关 API， 可 以 直接 操作 Android 手机 中 的 摄像 头 ， 以 方便 开发 自己 的 拍照 
程序 。 

使 用 Camera 类 访问 移动 设备 的 摄像 头 ， 需 要 在 应 用 程序 的 AndroidManifestxml 文件 中 
做 以 下 声明 : 

<uses-permission android:name="android.permission.CAMERA" /> 

<uses-feature android:name="android.hardware.camera" /> 


使 用 Camera 类 进行 拍照 的 步骤 如 下 : 


使 用 Camera.open() 方 法 获取 Camera 对 象 实例 。 

使 用 Camera.getParameters() 方 法 获取 当前 相机 的 相关 设置 。 

根据 需要 使 用 Camera.setParameters() 方 法 设置 相机 的 相关 参数 。 

根据 需要 使 用 Camera.setDisplayOrientation() 设 置 相机 正 向 。 

使 用 Camera.setPreviewDisplay0 〇 方法 为 相机 设置 一 个 用 于 显示 相机 图 像 的 Surface. 
使 用 Camera.startPreview() 启 动 预 览 。 

使 用 Camera.takePicture() 方 法 进行 拍照。 

进行 拍照 后 ， 预 览 视图 会 停止 。 使 用 Camera.startPreview() 方 法 重新 启动 预览 。 
使 用 Camera.stopPreview() 停 止 预览 。 
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© 使 用 Camera.release0 方 法 释放 相机 对 象 。 应 该 在 应 用 程序 的 onPause() 方 法 中 释放 相 
机 对 象 ， 在 onResume() 方 法 中 重新 打开 相机 对 象 。 


实例 MyCameraDemo 演示 了 使 用 Camera 类 进行 拍照 的 过 程 ， 该 应 用 程序 运行 效果 如 图 
6.9 所 示 。 


打开 摄像 头 ”拍摄 。 关闭 摄像 头 


图 6.9 MyCameraDemo 的 运行 效果 
该 视图 所 使 用 布局 文件 main.xml 内 容 如 下 : 


<?xml version="1.0" encoding="utf-8"?> 
<LinearLayout 
xmlns:android-"http://schemas.android.com/apk/res/android" 
android:layout width-"fill parent" 
android:layout height-"fill parent" 
android:orientation-"vertical"» 


«TextView 
android:layout width-"fill parent" 
android:layout height-"wrap content" 
android:text-"estring/hello" /> 


«SurfaceView 
android: id="@+id/surfaceView1" 
android: layout_width="fill parent" 
android: layout_height="wrap_ content" 
android: layout_weight="0.58" /> 


<LinearLayout 
android: id="@+id/linearLayout1" 


android:layout width-"match parent" 
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android:layout height-"wrap content" 
android:gravity-"center"» 


«Button 
android: id="@+id/button1" 
android: layout_width="wrap content" 
android:layout height-"wrap content" 
android: text="@string/opBtn"/> 


<Button 
android: id="@+id/button2" 
android: layout_width="wrap content" 
android:layout height-"wrap content" 
android:text-"estring/play" /> 


«Button 
android: id="@+id/button3" 
android: layout_width="wrap content" 
android:layout height-"wrap content" 
android:text-"Gstring/cloBtn" /> 
«/LinearLayout» 


</LinearLayout> 


实例 MyCameraDemo 使 用 到 的 资源 文件 string.xml 内 容 如 下 : 


<?xml version-"1.0" encoding-"utf-8"?» 
«resources» 


«string name= "he11o"> 使 用 android.hardware.Camera 进行 拍照 实例 </string> 
«string name="app_name">MyCameraDemo</string> 

«string name="opBtn"> 打 开 摄 像 头 </string> 

«string name= "play "> 拍摄 </string> 

«string name="cloBtn"> 关 闭 摄像 头 </string> 


</resources> 


由 于 实例 MyCameraDemo 中 涉及 了 将 拍摄 的 照片 保存 到 SD 卡 中 的 功能 ， 因 此 需要 在 该 
工程 的 AndroidManifest.xml 文件 中 声明 相应 权限 。 该 文件 内 容 如 下 : 


<?xml version="1.0" encoding="utf-8"?> 

«manifest xmlns:android="http: //schemas.android.com/apk/res/android" 
package= "introduction. android.myCameraDemo" 
android: versionCode="1" 
android: versionName="1.0"> 
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<uses-sdk android:minsdkVersion="14" /> 


<uses-feature android:name="android.hardware.camera"/> 
<uses-permission android:name="android.permission.CAMERA"/> 
<uses-permission 
android:name="android.permission.WRITE EXTERNAL STORAGE" /> 


<application 
android: icon="@drawable/ic_launcher" 
android: label="@string/app_name"> 
<activity 
android: label="@string/app name" 
android:name=".MyCameraDemoActivity"> 
<intent-filter> 
<action android:name="android.intent.action.MAIN" /> 


<category 
android:name-"android.intent.category.LAUNCHER" /> 
</intent-filter> 
</activity> 
</application> 


</manifest> 


实例 MyCameraDemo 的 主 Activity 为 MyCameraDemoActivity, Hefti F : 


package introduction.android.myCameraDemo; 


import java.io.BufferedOutputStream; 
import java.io.File; 

import java.io.FileNotFoundException; 
import java.io.FileOutputStream; 
import java.io.IOException; 


import android.app.Activity; 

import android.graphics.Bitmap; 

import android.graphics.BitmapFactory; 
import android.graphics.PixelFormat; 
import android.hardware.Camera; 

import android.hardware.Camera.Parameters; 
import android.hardware.Camera.PictureCallback; 
import android.os.Bundle; 

import android.util.Log; 

import android.view.SurfaceHolder; 

import android.view.SurfaceView; 

import android.view.View; 

import android.view.View.OnClickListener; 
import android.widget.Button; 
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public class MyCameraDemoActivity extends Activity { 
private Button opbtn; 
private Button playbtn; 
private Button clobtn; 
private SurfaceView surfaceView; 
private SurfaceHolder surfaceHolder; 
private Camera camera; 
private int previewWidth-320; 
private int previewHeight-240; 
protected String filepath-"/sdcard/mypicture.jpg"; 


/** Called when the activity is first created. */ 

GOverride 

public void onCreate (Bundle savedInstanceState) ( 
super.onCreate (savedInstanceState) ; 
setContentView (R.layout.main) ; 
opbtn- (Button) this.findViewById (R.id.buttonl) ; 
playbtn- (Button) this.findViewById (R.id.button2) ; 
clobtn- (Button) this.findViewById (R.id.button3) ; 
surfaceView- (SurfaceView) this.findViewById 

(R.id.surfaceView1) ; 

surfaceHolder-surfaceView.getHolder(); 
surfaceHolder.addCallback (new SurfaceHolder.Callback() { 


@Override 

public void surfaceDestroyed (SurfaceHolder holder) { 
// TODO Auto-generated method stub 
Log.i ("camera", "surface destroyed.") ; 


@Override 

public void surfaceCreated (SurfaceHolder holder) { 
// TODO Auto-generated method stub 
Log.i ("camera", "surface created.") ; 


@override 
public void surfaceChanged (SurfaceHolder holder, int 
format, 
int width, int height) { 


// TODO Auto-generated method stub 
Log.i ("camera", “surface changed.") ; 
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opbtn.setOnClickListener (new OnClickListener () { 


// 开 局 摄像 头 
@override 
public void onClick (View arg0) { 
// TODO Auto-generated method stub 


openCamera () ; 
} 
3g 
playbtn.setOnClickListener (new OnClickListener()( 
// 拍 照 
@Override 
public void onClick (View v) { 
// TODO Auto-generated method stub 
takePicture(); 
} 
3275 
clobtn.setOnClickListener (new OnClickListener() { 
// 关 闭 摄像 头 
@Override 


public void onClick (View v) { 
// TODO Auto-generated method stub 
closeCamera () ; 


protected void closeCamera() { 
// TODO Auto-generated method stub 
camera.stopPreview(); 
camera.release(); 
camera-null; 


protected void takePicture()( 
// TODO Auto-generated method stub 
if (checksDCard()) { 
camera.takePicture (null, null, jpeg) ; 
try { 
Thread.sleep (1000) ; 
} catch (InterruptedException e) { 
// TODO Auto-generated catch block 
e.printStackTrace(); 
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} 
camera.startPreview(); 
) else ( 
Log.e ("camera", "SD CARD not exist.") ; 
return; 


private void openCamera() { 


instance 


// TODO Auto-generated method stub 


try { 
camera=Camera.open(); // attempt to get a Camera 


} catch (Exception e) { 
// Camera is not available (in use or does not exist) 
Log.e ("camera", "open camera error!") ; 
e.printStackTrace(); 
return; 
) 
Parameters params-camera.getParameters(); 
params.setPreviewSize (previewWidth, previewHeight) ; 
params.setPictureFormat (PixelFormat.JPEG) ; 
params.setPictureSize (previewWidth, previewHeight) ; 
camera.setParameters (params) ; 
try ( 
camera.setPreviewDisplay (surfaceHolder) ; 
} catch (IOException e) { 
// TODO Auto-generated catch block 
Log.e ("camera", "preview failed.") ; 
e.printStackTrace() ; 
} 
camera.startPreview() ; 


private PictureCallback jpeg-new PictureCallback () { 


@Override 

public void onPictureTaken (byte[] data, Camera camera) { 
// TODO Auto-generated method stub 
Bitmap bitmap=BitmapFactory.decodeByteArray (data, 0, 


data.length) ; 
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storage permissions") ; 
return; 


try { 
// 将 拍摄 的 照片 写 入 sD 卡 中 


FileOutputStream fos=new FileOutputStream 


(pictureFile) ; 

BufferedOutputStream bos=new BufferedOutputStream 
(fos) ; 

bitmap.compress (Bitmap.CompressFormat.JPEG, 80, 
bos) ; 

bos.flush(); 

bos.close(); 

fos.close(); 


Log.i ("camera", "jpg file saved.") ; 
) catch (FileNotFoundException e) ( 
Log.d ("camera", "File not found: 
"+e.getMessage()) ; 
} catch (IOException e) { 
Log.d ("camera", "Error accessing file: 
"+e.getMessage()) ; 
} 


private boolean checkSDCard() { 
/1 判断 SD 存储 卡 是 否 存 在 
if (android.os.Environment.getExternalStorageState().equals ( 
android.os.Environment.MEDIA_MOUNTED) ) { 
return true; 
} else { 
return false; 


其 中 openCamera() 方 法 用 于 打开 当前 设备 的 相机 ， 并 通过 


Parameters params-camera.getParameters(); 
params.setPreviewSize (previewWidth, previewHeight) 
params.setPictureFormat (PixelFormat.JPEG) ; 
params.setPictureSize (previewWidth, previewHeight) ; 
camera.setParameters (params) ; 


设置 了 相机 的 相关 参数 ， 以 用 于 照片 拍摄 。 
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通过 以 下 代码 : 


surfaceView= (SurfaceView) this.findViewById (R.id.surfaceView1) ; 
surfaceHolder-surfaceView.getHolder(); 
camera.setPreviewDisplay (surfaceHolder) ; 


将 布局 中 的 SurfaceView 组 件 设置 为 相机 的 预览 窗口 。 
由 于 在 拍摄 照片 后 ， 预 览 视 图 会 自动 停止 预览 而 显示 拍摄 到 的 照片 ， 因 此 在 本 例 中 人 为 


将 照片 显示 时 间 设 定 为 1S， 然 后 重新 启动 预览 。 相 关 代 码 如 下 : 


camera.takePicture (null, null, jpeg) ; 
try { 
Thread.sleep (1000) ; 
} catch (InterruptedException e) { 
// TODO Auto-generated catch block 
e.printStackTrace(); 


] 


camera.startPreview(); 


6.4.4 


录制 视频 


视频 录制 也 可 以 通过 MediaRecorder 类 进行 完成 ， 其 基本 步骤 与 音频 录制 基本 相同 ， 只 
是 添加 了 一 些 对 视频 进行 处 理 的 步骤 。 
视频 录制 的 基本 步骤 如 下 : 


zi) 


ar 


调用 Camera.open() 方 法 打开 摄像 头 。 

调用 Camera.setPreviewDisplay0 连 接 预览 窗口 ， 以 便 将 从 摄像 头 获取 的 图 像 放 置 到 
预览 窗口 中 显示 出 来 。 

调用 Camera.startPreview() 启 动 预览 ， 显 示 摄 像 头 拍摄 到 的 图 像 。 

使 用 MediaRecorder 进行 视频 录制 。 


1. 使 用 Cameraunlock() 方 法 解锁 摄像 头 ， 以 使 MediaRecorder 获 得 对 摄像 头 的 使 用 权 。 
2. 配置 MediaRecorder。 
(1) 建立 MediaRecorder 类 的 对 象 ， 并 设置 音频 源 和 视频 源 : 


MediaRecorder recorder-new MediaRecorder () ; 
recorder.setAudioSource (MediaRecorder.AudioSource.MIC) ; 
recorder.setVideoSource (MediaRecorder.VideoSource.CAMERA) ; 


(2) 设置 视频 的 输出 和 编码 格式 。 在 Android2.2 (API Level 8) 以 上 版 本 的 SDK 中 ， 可 
以 直接 调用 MediaRecorder setProfile 方法 进行 相关 配置 : 


recorder.setProfile (CamcorderProfile.get 
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(CamcorderProfile.QUALITY_LOW) ) ; 


其 中 MediaRecorder.setProfileQ 77? Android 2.2 (API Level8) 之 后 MediaRecorder 类 
新 提供 的 方法 ， 通 过 CamcorderProfile 对 象 可 用 于 对 MediaRecorder 进行 相关 设置 。 

CamcorderProfile 为 预先 定义 好 的 一 组 视频 录制 相关 配置 信息 ，Android SDK 共 定 义 了 十 
四 种 CamcorderProfile 配置 ， 如 CamcorderProfile. QUALITY HIGH, CamcorderProfile. 
QUALITY LOW, CamcorderProfile. QUALITY TIME LAPSE 1080P 等 。 其 中 QUALITY LOW 
和 QUALITY HIGH 两 种 配置 是 所 有 的 摄像 头 都 支持 的 ， 其 他 配置 则 根据 硬件 性 能 决定 。 每 

-种 配置 都 涉及 文件 输出 格式 、 视 频 编码 格式 、 视 频 比 特 率 、 视 频 帧 率 、 视 频 的 高 和 宽 、 音 

频 编码 格式 、 音 频 的 比特 率 、 音 频 采 样 率 和 音频 录制 的 通道 数 几 个 方面 。 通 过 使 用 这 些 预定 
义 配 置 能 够 降低 代码 复杂 度 ， 提 高 编码 效率 。 

G) 设置 录制 的 视频 文件 的 保存 位 置 及 文件 名 : 


MediaRecorder.setOutputFile (PATH NAME) ; 


(4) 使 用 MediaRecorder.setPreviewDisplay0 方 法 指定 MediaRecorder 的 视频 预览 窗口 ， 该 
方法 所 指定 的 SurfaceView 应 该 和 步骤 (2) 中 的 相同 。 

需要 注意 的 是 ， 以 上 配置 过 程 必须 按照 顺序 进行 ， 否 则 会 发 生 错误 。 

3. 将 录像 器 置 于 准备 状态 : 


MediaRecorder.prepare() ; 
4. 启动 录像 器 : 
MediaRecorder.start(); 
5. 进行 视频 录制 : 
CES 视频 录制 完成 后 ， 可 使 用 以 下 方法 停止 视频 录制 。 
1. 停止 录像 器 : 
MediaRecorder.stop(); 
2. 重 置 录 像 器 的 相关 配置 : 


MediaRecorder.reset () 


3. 释放 录像 器 对 象 : 

MediaRecorder.release(); 

4. 调用 Cameralock() 方 法 锁定 摄像 头 。 从 Android4.0 开始 ， 该 调用 也 不 再 必须 ， 除 非 
MediaRecorderprepare() 方 法 失败 。 
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调用 Camera.stopPreview() 方 法 停止 预览 。 
调用 Camera.release() 方 法 释放 摄像 头 。 


另外 ， 在 Android 4.0 系统 下 ，Cameraunlock() 方 法 和 Camera.lock0) 方 法 可 由 Android 框 
实例 VideoRecorderDemo 演示 了 使 用 MediaRecorder 进行 视频 录制 的 过 程 ， 该 实例 运行 
效果 如 图 6.10 所 示 。 


打开 摄像 头 ”录制 ”关闭 摄像 头 


图 6.10 VideoRecorderDemo 的 运行 效果 


实例 VideoRecorderDemo 使 用 的 布局 文件 main.xml 文 件 内 容 如 下 : 


<?xml version="1.0" encoding="utf-8"?> 


<LinearLayout 


xmlns:android-"http://schemas.android.com/apk/res/android" 
android:layout width-"fill parent" 

android:layout height-"fill parent" 
android:orientation-"vertical"» 
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«TextView 
android 


«SurfaceView 
android 


:layout width-"fill parent" 
android: 
android: 


layout height-"wrap content" 
text="@string/hello" /> 


:id="@+id/surfaceViewl" 
android: 
android: 
android: 


layout_width="fill parent" 
layout height-"wrap content" 
layout weight-"0.58" /» 


fe, 
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<LinearLayout 
android: id="@+id/linearLayout1" 
android:layout width-"match parent" 
android:layout height-"wrap content" 
android:gravity-"center"» 


«Button 


android: id="@+id/button1" 

android: layout_width="wrap_ content" 
android:layout height-"wrap content" 
android: text="@string/opBtn"/> 


<Button 


android: id="@+id/button2" 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:text-"Gstring/play" /> 


«Button 


android: id="@+id/button3" 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:text-"Gstring/cloBtn" /> 


«/LinearLayout» 


</LinearLayout> 


其 对 应 的 资源 文件 strings.xml 内 容 如 下 : 


<?xml version-"1.0" encoding-"utf-8"?» 
«resources» 


«string 
«string 
«string 
«string 
«string 


name- "hel1o"> 使 用 MediaRecorder 进行 视频 录制 实例 </string> 
name-"app name"»VideoRecorderDemo«/string» 

name= "opBtn"> 打 开 摄 像 头 </string> 

name= "play "> 录制 </string> 

name- "cl1oBtn "> 关闭 摄像 头 </string> 


</resources> 


由 于 实例 VideoRecorderDemo 中 涉及 了 音频 录制 、 使 用 摄像 头 、 向 SD 卡 写 文件 等 操 
因此 需要 在 该 工程 的 AndroidManifest.xml 文件 中 声明 相应 权限 。 该 文件 内 容 如 下 : 


<?xml version="1.0" encoding="utf-8"?> 
«manifest xmlns:android="http: //schemas.android. com/apk/res/android" 
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package="introduction.android.videoRecorderDemo" 
android:versionCode="1" 
android: versionName="1.0"> 


<uses-sdk android:minSdkVersion="14" /> 
<uses-permission android:name="android.permission.CAMERA" /> 
«uses-feature android:name-"android.hardware.camera" /> 
«uses-feature android:name-"android.hardware.camera.autofocus" /> 
«uses-permission android:name- "android.permission.RECORD AUDIO"/» 
«uses-permission 
android:name-"android.permission.WRITE EXTERNAL STORAGE" /» 


«application 


android: icon="@drawable/ic_launcher" 
android: label="@string/app_name"> 
<activity 
android: label="@string/app_ name" 
android:name=".VideoRecorderDemoActivity"> 
<intent-filter> 
<action android:name="android.intent.action.MAIN" /> 


<category 


android:name-"android.intent.category.LAUNCHER" /> 
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</intent-filter> 
</activity> 


</application> 


</manifest> 


实例 VideoRecorderDemo 的 主 Activity 为 VideoRecorderDemoActivity， 其 代码 如 下 : 


package introduction.android.videoRecorderDemo; 


import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 


java.io.IOException; 
android.app.Activity; 
android.graphics.PixelFormat; 
android.hardware.Camera; 
android.hardware.Camera.Parameters; 
android.media.MediaRecorder; 
android.os.Bundle; 
android.util.Log; 
android.view.SurfaceHolder; 
android.view.SurfaceView; 
android.view.View; 
android.view.View.OnClickListener; 
android.widget.Button; 
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public class VideoRecorderDemoActivity extends Activity { 
private Button opbtn; 
private Button playbtn; 
private Button clobtn; 
private SurfaceView surfaceView; 
private SurfaceHolder surfaceHolder; 
private Camera camera; 
private MediaRecorder videoRecorder; 
private String myVideofilepath="/sdcard/myVideo.3gp"; 
/** Called when the activity is first created. */ 
@Override 
public void onCreate (Bundle savedInstanceState) { 
super .onCreate (savedInstanceState) ; 
setContentView (R.layout.main) ; 
opbtn- (Button) this.findViewById (R.id.buttonl) ; 
playbtn- (Button) this.findViewById (R.id.button2) ; 
clobtn= (Button) this.findViewById (R.id.button3) ; 
videoRecorder=new MediaRecorder(); 
surfaceView= (SurfaceView) this.findViewById 
(R.id.surfaceViewl) ; 
surfaceHolder-surfaceView.getHolder(); 
surfaceHolder.addCallback (new SurfaceHolder.Callback() { 


@Override 

public void surfaceDestroyed (SurfaceHolder holder) { 
// TODO Auto-generated method stub 
Log.i ("videoRecorder", "surface destroyed.") ; 
surfaceHolder-null; 
stopRecording(); 
releaseCamera(); 


@Override 

public void surfaceCreated (SurfaceHolder holder) { 
// TODO Auto-generated method stub 
Log.i ("videoRecorder", "surface created.") ; 
surfaceHolder=holder; 


@override 
public void surfaceChanged (SurfaceHolder holder, int 


format, 
int width, int height) { 
// TODO Auto-generated method stub 
Log.i ("videoRecorder", "surface changed.") ; 
surfaceHolder=holder; 
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Dy 
opbtn.setOnClickListener (new OnClickListener () { 


@override 

public void onClick (View arg0) { 
// TODO Auto-generated method stub 
openCamera () ; 


2285 
playbtn.setOnClickListener (new OnClickListener()( 


@Override 

public void onClick (View v) { 
// TODO Auto-generated method stub 
benginRecording() ; 


2087 
clobtn.setOnClickListener (new OnClickListener()( 


@Override 

public void onClick (View v) { 
// TODO Auto-generated method stub 
stopRecording(); 


0; 


@Override 
protected void onPause() { 
// TODO Auto-generated method stub 
super. onPause() ; 
stopRecording(); 
releaseCamera(); 


protected void stopRecording() { 
// TODO Auto-generated method stub 
Log.i ("videoRecorder","stopRecording....") ; 
if (videoRecorder!-null) ( 
videoRecorder.stop(); 
videoRecorder.reset(); 
videoRecorder.release(); 
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videoRecorder-null; 
camera.lock(); 
} 
5 
private void releaseCamera() { 
if (camera !-null) ( 
camera.release(); // release the camera for other 
applications 
camera-null; 
} 
} 
protected void benginRecording() { 
// TODO Auto-generated method stub 
Log.i ("videoRecorder", "beginRecording.") ; 
// 给 摄像 头 解锁 
camera.unlock(); 
/ /MediaRecorder 获取 到 摄像 头 的 访问 权 
videoRecorder.setCamera (camera) ; 
// 设 置 视频 录制 过 程 中 所 录制 的 音频 来 自 手 机 的 麦克 风 
videoRecorder .setAudioSource 
(MediaRecorder .AudioSource.CAMCORDER) ; 
// 设 置 视频 源 为 摄像 头 
videoRecorder.setVideoSource 
(MediaRecorder.VideoSource.CAMERA) ; 
// 设 置 视频 录制 的 输出 文件 格式 为 3gp 文件 
videoRecorder.setOutputFormat 
(MediaRecorder.OutputFormat.THREE GPP) ; 
// 设 置 音频 编码 方式 为 AAC 
videoRecorder .setAudioEncoder 
(MediaRecorder.AudioEncoder.AAC) ; 
// 设置 录制 的 视频 编码 方式 为 H.264 
videoRecorder.setVideoEncoder 
(MediaRecorder.VideoEncoder.H264) ; 
// 设置 视频 录制 的 分 辩 率 ， 必 须 放 在 设置 编码 和 格式 的 后 面 ， 否 则 报错 
videoRecorder.setVideoSize (176, 144) ; 
// 设置 录制 的 视频 帧 率 ， 必 须 放 在 设置 编码 和 格式 的 后 面 ， 否 则 报错 
videoRecorder.setVideoFrameRate (20) ; 
if (!checkSDCard()) { 
Log.e ("videoRecorder", "未 找到 SD 卡 ! ") ; 
return; 
} 
videoRecorder.setOutputFile (myVideofilepath) ; 
videoRecorder.setPreviewDisplay (surfaceHolder.getSurface()) ; 
try { 
videoRecorder.prepare(); 
} catch (IllegalStateException e) { 
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// TODO Auto-generated catch block 
e.printStackTrace(); 

} catch (IOException e) { 
// TODO Auto-generated catch block 
e.printStackTrace(); 

} 

videoRecorder.start(); 


} 
private void openCamera() { 
// TODO Auto-generated method stub 
Log.i ("videoRecorder", "openCamera.") ; 
try { 
camera=Camera.open(); // attempt to get a Camera 


instance 

} catch (Exception e) { 
// Camera is not available (in use or does not exist) 
Log.e ("camera", "open camera error!") ; 
e.printStackTrace() ; 
return; 

} 

try { 
camera.setPreviewDisplay (surfaceHolder) ; 

} catch (IOException e) { 
// TODO Auto-generated catch block 
Log.e ("camera", "preview failed.") ; 
e.printStackTrace(); 

} 

camera.startPreview(); 

} 


private boolean checkSDCard() { 
// 判断 SD 存储 卡 是 否 存在 


if (android.os.Environment.getExternalStorageState().equals ( 
android.os.Environment.MEDIA MOUNTED) ) { 
return true; 
} else { 
return false; 


该 实例 中 ， 在 对 MediaRecorder 进行 设置 时 ， 没 有 使 用 


videoRecorder.setProfile (CamcorderProfile.get 
(CamcorderProfile.QUALITY_LOW) ) ; 


而 是 使 用 以 下 代码 为 MediaRecorder 进行 了 设置 : 
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/ /设置 视 频 录制 的 输出 文件 格式 为 3gp 文件 videoRecorder.setOutputFormat 

(MediaRecorder.OutputFormat.THREE GPP) ; 

// 设 置 音频 编码 方式 为 RRC 

videoRecorder .setAudioEncoder 
(MediaRecorder.AudioEncoder.AAC) ; 

// 设置 录制 的 视频 编码 方式 为 H.264 

videoRecorder .setVideoEncoder 
(MediaRecorder.VideoEncoder.H264) ; 

// 设置 视频 录制 的 分 辩 率 ， 必 须 放 在 设置 编码 和 格式 的 后 面 ， 否 则 报错 


videoRecorder.setVideoSize (176, 144) ; 


// 设置 录制 的 视频 帧 率 ， 必 须 放 在 设置 编码 和 格式 的 后 面 ， 否 则 报错 


videoRecorder.setVideoFrameRate (20) ; 


6.5 小 结 


本 章 介 绍 了 Service 的 相关 知识 ， 涉 及 了 Service 的 生命 周期 和 使 用 方法 。Service 是 一 种 
与 Activity 类 似 的 程序 ， 不 同 的 是 它 没有 用 户 界面 ， 只 能 在 后 台 运 行 。Service 适合 执行 一 些 
较为 耗 时 的 工作 。 当 Service 被 启动 后 ， 它 会 一 直 在 后 台 运 行 ， 直 到 调用 了 Service 的 
stopService() 方 法 才 终 止 服务 。 例 如 本 章 中 实现 的 后 台 音频 播放 程序 ， 当 离开 音频 播放 的 主 界 
面 时 ， 音 乐 还 是 会 一 直播 放 。 

Service 的 功能 不 仅 如 此 ， 在 日 后 的 学 习 过 程 中 ， 会 接触 到 更 多 的 和 Service 相关 的 开发 
方法 。 

本 章 还 简单 介绍 了 BroadcastReceiver 的 使 用 方法 。BroadcastReceiver 是 Android 系统 中 
的 广播 接收 者 ， 通 过 BroadcastReceiver 可 以 轻松 实现 对 Android 系统 中 特定 事件 的 处 理 ， 例 
如 当 有 来 电 、 电 池 电 量 发 生变 化 等 事件 发 生 时 ， 可 以 使 程序 员 通 过 自己 开发 的 应 用 程序 对 事 
件 进 行 处 理 。 

此 外 ， 本 章 介绍 了 多 媒体 开发 相关 的 知识 ， 如 视频 播放 、 音 频 播 放 、 视 频 和 音频 的 录 
制 、 使 用 照相 机 拍照 等 ， 其 中 涉及 了 Android 系统 的 硬件 编程 。 读 者 可 以 举一反三 ， 对 
Android 系统 提供 的 硬件 资源 进行 更 多 的 开发 。 


6.6 思考 是 


- 尝试 开发 自己 的 音频 播放 器 。 

2. 尝试 开发 自己 的 视频 播放 器 。 

- 尝试 开发 自己 的 照相 机 应 用 程序 。 

4. 怎么 才能 实现 远程 控制 其 他 手机 进行 后 台 录 音 ? 


= 


w 
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5. 使 用 MediaRecorder 进行 视频 录制 时 ， 能 否 不 出 现 界面 而 在 后 台 录 制 视频 ? 
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数据 存储 


从 本 章节 可 以 学 习 到 ; 


党 SharedPreferences 
* 文件 存储 

* SQLite 

** ContentProvider 
* 数据 同步 到 云端 
^ 数据 备份 与 恢复 
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不 管 是 桌面 应 用 程序 还 是 Android 手机 应 用 程序 ， 都 会 涉及 数据 的 存储 。 本 章 将 详细 介 
绍 在 Android 中 数据 存储 的 相关 知识 。 

在 Android 中 应 用 程序 存储 的 数据 (包括 文件 ) 都 属于 应 用 程序 私有 ， 但 同时 也 提供 了 
Content Providers (数据 共享 ) ， 方 便 应 用 程序 将 私有 的 数据 分 享 给 其 他 程序 使 用 。 其 中 数据 
存储 方式 共 分 为 五 种 ， 分 别 为 : 


SharedPreferences. 

内 部 存储 (Internal Storage) . 
外 部 存储 (External Storage) . 
SQLite 数据 库存 储 。 

网 络 存储 。 


其 中 网 络 存储 在 本 质 上 是 对 网 络 资源 的 获取 和 访问 ， 其 相关 内 容 会 在 网 络 编程 章节 中 进 
行 介绍 ， 本 章 主要 介绍 前 四 种 ， 其 中 内 部 存储 和 外 部 存储 统称 为 文件 存储 。 此 外 ，Android 
系统 框架 提供 了 ContentProvider 来 实现 各 种 应 用 程序 间 持 久 化 数据 的 共享 。 


/. ] SharedPreferences 


SharedPreferences 是 Android 系统 提供 的 一 个 通用 的 数据 持久 化 框架 ， 用 于 存储 和 读 取 
key-value 类 型 的 原始 基本 数据 类 型 对 ， 目 前 仅 支持 boolean, float, int, long 和 string 等 基本 
类 型 的 存储 ， 对 于 自 定义 的 复合 数据 类 型 ， 是 无 法 使 用 SharedPreferences 进行 存储 的 。 


7.1.1 SharedPreferences 简介 


SharedPreferences 主要 用 于 存储 系统 的 配置 信息 ， 类 似 于 Windows 下 常用 的 .ini 文件 ， 
例如 上 次 登录 的 用 户 名 、 上 次 最 后 设置 的 信息 等 ， 通 过 保存 上 一 次 用 户 所 做 的 修改 或 者 自 定 
义 参 数 设 定 ， 当 再 次 启动 程序 后 依然 保持 原 有 设置 。 它 是 用 键 值 对 的 方式 存储 ， 方 便 管理 写 
入 和 读 取 。 

使 用 SharedPreferences 的 步骤 如 下 : 


€) 获取 Preferences。 每 个 Activity 默认 都 有 一 个 SharedPreferences F $, KR 
SharedPreferences 对 象 的 方法 有 两 种 : 
*  SharedPreferences getSharedPreferences ( String name, int mode) 。 使 用 该 方法 获 
取 到 name 指定 的 SharedPreferences 对 象 ， 并 获取 对 该 SharedPreferences 对象 的 读 
写 控制 权 。 当 应 用 程序 中 可 能 使 用 到 多 个 SharedPreferences 时 使 用 该 方法 。 
* SharedPreferences getPreferences (int mode) 。 当 应 用 程序 中 仅 需 要 一 个 
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SharedPreferences 对 象 时 ， 使 用 该 方法 获取 当前 Activity 对 应 的 
SharedPreferences， 而 不 需要 指定 SharedPreferences 的 名 字 。 


其 中 参数 mode 有 四 种 取 值 ， 分 别 是 : 


* MODE PRIVATE 默认 方式 ， 只 能 被 创建 应 用 程序 或 者 与 创建 与 应 用 程序 具 
有 相同 用 户 ID 的 应 用 程序 访问 ; 
* MODE WORLD READABLE 允许 其 他 应 用 程序 对 该 SharedPreferences 文 
件 进行 读 操 作 ; 
* MODE WORLD WRITEABLE 允许 其 他 应 用 程序 对 该 SharedPreferences 文 
件 进行 写 操 作 ; 
* MODE MULTI PROCESS 在 多 进程 应 用 程序 中 ， 当 多 个 进程 都 对 同一 个 
SharedPreferences 进行 访问 时 ， 该 文件 的 每 次 修改 都 会 被 重新 核对 。 
C€XX0 调用 edit( 方 法 获取 SharedPreferences.Editor，SharedPreferences 通过 该 接口 对 其 内 容 
进行 更 新 。 
€ 通过 SharedPreferences.Editor 接 口 提供 的 put 方法 对 SharedPreferences 进行 更 新 。 例 
如 使 用 putBoolean ( String key, boolean value) 、 putFloat ( String key, float value ) 
等 方法 将 相应 数据 类 型 的 数据 与 其 key 对 应 起 来 
人 4 调用 SharedPreferences.Editor 的 commit() 方 法 ， 将 更 新 提交 到 SharedPreferences 中 。 


7.1.2 ”使 用 SharedPreferences 


实例 SharedPreferencesDemo 演示 了 SharedPreferences 
对 象 的 使 用 方法 。 该 实例 的 运行 效果 如 图 7.1 所 示 。 当 用 Bl sharedPreferencesDemo 
户 在 该 实例 运行 时 在 文本 框 中 输入 电话 号 码 和 所 在 城市 ， Pr TII 
例如 13088888888 和 beijing， 单 击 回 退 按钮 退出 应 用 程序 
时 ， 该 应 用 程序 将 相关 信息 写 入 到 其 对 应 的 SharedPreferences 
中 。 当 用 户 再 次 启动 该 应 用 程序 时 ， 之 前 填写 到 文本 框 内 EIU 
的 信息 会 被 从 SharedPreferences 中 读 取 出 来 ， 并 显示 出 
来 ， 以 方便 用 户 修改 。 

实例 SharedPreferencesDemo 中 的 布局 文件 main.xml 
中 放置 了 三 个 TextView 和 两 个 EditText， 其 中 两 个 
EditText 按照 TextView 的 要 求 输入 电话 号 码 和 城市 。 其 代 
人 码 如 下 : 


13088888888 
市 


<?xml version="1.0" encoding="utf-8"?> 
<LinearLayout 
xmlns:android="http://schemas.android.com/apk/ 图 7.1 SharedPreferencesDemo 界面 
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res/android" 
android:layout width-"fill parent" 
android:layout height-"fill parent" 
android:orientation="vertical"> 
<TextView 
android: layout_width="fill_parent" 
android: layout_height="wrap_content" 
android: text="{#}f] Shared Preferences 存储 程序 信息 ” /> 
<TextView 
android:layout width-"fill parent" 
android:layout height-"wrap content" 
android:text=" 您 的 电话 号 码 : "/» 
<EditText 
android: id="@+id/phone_text" 
android: layout_width="fill_parent" 
android: layout_height="wrap_content" 
android:hint=" 输 入 电话 号 码 "/> 
<TextView 
android:layout width-"fill parent" 
android:layout height-"wrap content" 
android:text=" 您 所 在 的 城市 "/> 
<EditText 
android:id-"G«id/city text" 
android:layout width-"fill parent" 
android:layout height-"wrap content" 
android:hint=" 输 入 城市 名 称 " /> 
</LinearLayout> 


实例 SharedPreferencesDemo 中 的 AndroidManifest.xml 代码 如 下 : 


<?xml version="1.0" encoding="utf-8"?> 
«manifest xmlns:android-"http://schemas.android.com/apk/res/android" 
package="introduction.android.SharedPreferencesDemo" 
android: versionCode="1" 
android:versionName="1.0"> 
<uses-sdk android:minSdkVersion-"14" /> 
<application 
android: icon="@drawable/ic_launcher" 
android: label="@string/app_name"> 
<activity 
android:name=".SharedPreferencesDemo" 
android: label="@string/app_name"> 
<intent-filter> 
<action android:name="android.intent.action.MAIN" /> 
<category 
android:name="android.intent.category. LAUNCHER" /> 
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</intent-filter> 
</activity> 
</application> 
</manifest> 


实例 SharedPreferencesDemo 中 的 SharedPreferencesDemo.java 代码 如 下 : 


package introduction.android.SharedPreferencesDemo; 
import javax.security.auth.PrivateCredentialPermission; 
import introduction.android.SharedPreferencesDemo.R; 
import android.app.Activity; 
import android.content.SharedPreferences; 
import android.os.Bundle; 
import android.widget.EditText; 
public class SharedPreferencesDemo extends Activity ( 
private EditText phoneText,cityText; 
private String phone,city; 
public static final String SET INFO-"SET Info"; 
public static final String PHONE-"PHONE"; 
public static final String CITY="CITY"; 
@Override 
public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState) ; 
setContentView (R.layout.main) ; 
phoneText= (EditText) findViewById (R.id.phone text) ; 
cityText- (EditText) findViewById (R.id.city text) ; 
/*3kM Shared Preferences 对 象 */ 
SharedPreferences setinfo-getPreferences 
(Activity.MODE PRIVATE) ; 
/* 取 出 保存 的 电话 号 码 和 地 址 信息 */ 
phone=setinfo.getString (PHONE,"") ; 
city=setinfo.getString (CITY, "") ; 
/* 将 取出 的 信息 分 别 放 在 对 应 的 EditText 中 */ 
phoneText.setText (phone) ; 
cityText.setText (city) ; 
} 
@Override 
protected void onStop() { 
SharedPreferences setinfo=getPreferences 
(Activity.MODE PRIVATE) ; 
setinfo.edit() 
.putString (PHONE, phoneText.getText ().toString()) 
.putString (CITY,cityText.getText().toString()) 
.commit(); 
super.onStop(); 
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该 Activity 在 启动 时 通过 onCreate() 方 法 从 其 SharedPreferences 中 获取 相应 数据 ， 在 
onStop0 方 法 中 将 相应 数据 写 入 到 SharedPreferences 中 。 其 中 : 


SharedPreferences setinfo=getPreferences (Activity.MODE_PRIVATE) ; 


用 于 获取 当前 Activity 默认 的 SharedPreferences 对 象 ， 该 对 象 没 有 名 字 。 当 然 也 可 以 通 
过 getSharedPreferences(String name, int mode) 方 法 来 创建 并 获取 一 个 带 有 名 字 的 
SharedPreferences 。 当 该 SharedPreferences 被 创建 后 ， 可 以 在 应 用 程序 的 包 路 径 下 ， 即 
data/data/<your package name>/shared_prefs 文件 夹 下 找到 该 文件 。 


J .2 文件 存储 


7.2.1 ”文件 存储 方式 简介 


Android 的 文件 存储 方式 分 为 两 种 :内 部 存储 (Internal Storage) 和 外 部 存储 (External 
Storage) 。 


1. 内 部 存储 


内 部 存储 是 指 将 应 用 程序 的 数据 以 文件 方式 存储 到 设备 内 存 中 。 内 部 存储 方式 存储 的 文 
件 被 其 所 创建 的 应 用 程序 私有 ， 其 他 应 用 程序 无 权 进 行 操作 。 当 创建 的 应 用 程序 被 卸载 时 ， 
其 内 部 存储 文件 也 随 之 被 删除 。 当 内 部 存储 器 的 存储 空间 不 足 时 ， 缓 存 文件 可 能 会 被 删除 以 
释放 空间 ， 因 此 ， 缓 存 文件 是 不 可 靠 的 。 当 使 用 缓存 文件 时 ， 自 己 应 该 维护 好 缓存 文件 ， 并 
且 将 缓存 文件 限制 在 特定 大 小 之 内 。 

使 用 文件 存储 信息 时 ， 使 用 openFileOutput 和 openFileInput 进行 文件 的 读 写 ， 这 跟 Java 
中 的 VO 程序 很 类 似 。 创 建 并 写 内 部 存储 文件 的 步骤 如 下 : 


€o 通过 ContextopenFileOutput ( String name, int mode) 方法 打开 文件 并 设 定 读 写 方 
式 ， 返 回 FileOutputStream。 
其 中 ， 参 数 mode 取 值 为 : 


* MODE PRIVATE， 默 认 访 问 方 式 ， 文 件 仅 能 被 创建 应 用 程序 访问 。 

* MODE APPEND， 若 文件 已 经 存在 ， 则 在 文件 未 尾 继续 写 入 数据 ， 而 不 抹 
掉 文 件 原 有 内 容 。 

e MODE WORLD READABLE， 人 允许 该 文件 被 其 他 应 用 程序 执行 读 取 内 容 
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e MODE WORLD WRITEABLE， 人 允许 该 文件 被 其 他 应 用 程序 执行 写 操作 。 
人 2 调用 FileOutputStream .write0 方 法 写 入 数据 。 
€o 调用 FileOutputStream.close() 方 法 关闭 输出 流 ， 完 成 写 操作 。 


内 部 存储 文件 的 写 文件 示例 代码 如 下 : 


String FILENAME="hello_file"; 

String string="hello world!"; 

FileOutputStream fos=openFileOutput (FILENAME, Context.MODE_PRIVATE) ; 
fos.write (string.getBytes()) ; 

fos.close(); 


2. 外 部 存储 


外 部 存储 是 指 将 文件 存储 到 一 些 外 部 存储 设备 上 ， 例 如 SD 卡 或 者 设备 内 鸯 的 存储 卡 ， 
属于 永久 性 的 存储 方式 。 外 部 存储 的 文件 不 被 某 个 应 用 程序 所 特有 ， 但 可 以 被 其 他 应 用 程序 
共享 ， 当 将 该 外 部 存储 设备 连接 到 计算 机 上 时 ， 这 些 文件 可 以 被 浏览 、 修 改 和 删除 。 因 此 这 
种 存储 方式 不 具有 安全 性 。 

由 于 外 部 存储 器 可 能 处 于 被 移 除 、 连 接 到 计算 机 、 丢 失 、 只 读 或 者 其 他 各 种 状态 ， 因 此 
在 使 用 外 部 存储 之 前 ， 必 须 使 用 Environment.getExternalStorageState() 方 法 来 确认 外 部 存储 器 
是 否 可 用 。 验 证 外 部 存储 器 是 否 可 读 写 的 代码 如 下 : 

boolean mExternalStorageAvailable=false; 

boolean mExternalStorageWriteable=false; 


String state-Environment.getExternalStorageState(); 
if (Environment.MEDIA MOUNTED.equals (state) ) ( 
// 外 部 存储 器 可 读 写 
mExternalStorageAvailable=mExternalStorageWriteable=true; 
} else if (Environment.MEDIA MOUNTED READ ONLY.equals (state) ) { 
// 外 部 存储 器 可 读 不 可 写 
mExternalStorageAvailable=true; 
mExternalStorageWriteable=false; 
} else { 
// 外 部 存储 器 不 可 读 写 ， 处 于 其 他 状态 
mExternalStorageAvailable=mExternalStorageWriteable=false; 
5 


此 外 ， 在 程序 开发 过 程 中 还 可 以 使 用 缓存 文件 〈Cache) ， 内 部 存储 和 外 部 存储 都 可 以 用 
于 保存 缓存 文件 。 当 存储 器 的 存储 空间 不 足 时 ， 缓 存 文件 可 能 会 被 删除 以 释放 空间 。 因 此 ， 
缓存 文件 是 不 可 靠 的 。 当 使 用 缓存 文件 时 ， 应 该 自己 维护 好 缓存 文件 ， 并 且 将 缓存 文件 限制 
在 特定 大 小 之 内 。 
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7.2.2 ”使 用 文件 存储 功能 


实例 FileDemo 演示 了 使 用 文件 存储 的 功能 ， 其 运行 效果 如 图 7.2 所 示 。 该 实例 将 文本 框 
中 输入 的 内 容 存储 到 名 为 text 的 文件 中 。 当 该 应 用 程序 再 次 启动 时 ， 可 以 从 text 文件 中 写 入 
的 内 容 读 取 并 显示 出 来 。 本 实例 使 用 了 内 部 存储 方式 ， 读 者 可 以 在 data/data/<your package 
name>/files 目录 下 找到 该 名 为 text 的 文件 。 本 实例 没有 将 文件 放置 到 SD 卡 中 ， 读 者 可 以 自 
行 实现 将 文件 保存 在 SD 卡 中 的 操作 。 


| L5 | L5 


保存 信息 读 取信 息 保存 信息 GER 


数据 保存 成 功 保存 的 数据 是 : hello;world. 


图 7.2 FileDemo 界面 


实例 FileDemo 中 的 布局 文件 main.xml 中 放置 了 两 个 TextView、 一 个 EditText 和 两 个 
Button， 其 代码 如 下 : 


<?xml version="1.0" encoding-"utf-8"?» 
<LinearLayout 
xmlns:android="http: //schemas.android.com/apk/res/android" 
android: layout_width="fill_parent" 
android:layout height-"fill parent" 
android:orientation-"vertical"» 
«TextView 
android:layout width-"fill parent" 
android:layout height-"wrap content" 
android:text=" 使 用 文件 存储 程序 信息 ” /> 
<TextView 
android:layout width-"fill parent" 
android:layout height-"wrap content" 
android:text=" 输 入 您 存储 的 信息 " /> 
<EditText 
android:id="@+id/phone text" 
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android: layout_width="fill_parent" 
android: layout_height="wrap_content" 
android:hint=" 输 入 保存 的 信息 " /> 
<LinearLayout 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:orientation-"horizontal"'» 
«Button 
android:id-"e«id/SaveButton" 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:text=" 保 存 信 息 "/> 
<Button 
android:id="@+id/LoadButton" 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:text=" 读 取信 息 "/> 
</LinearLayout> 


</LinearLayout> 


实例 FileDemo 中 的 AndroidManifest.xml 文件 代码 如 下 : 


<?xml version="1.0" encoding="utf-8"?> 
<manifest xmlns:android="http://schemas.android.com/apk/res/android" 
package="introduction.android.fileDemo" 
android:versionCode="1" 
android:versionName="1.0"> 
<uses-sdk android:minsdkVersion="14" /> 
<application 
android: icon="@drawable/ic_launcher" 
android: label="@string/app_name"> 
<activity 
android:name="introduction. android. fileDemo.FileDemo" 
android: label="@string/app_name"> 
<intent-filter> 
<action android:name="android.intent.action.MAIN" /> 
<category 
android:name="android.intent.category. LAUNCHER" /> 
</intent-filter> 
</activity> 
</application> 
</manifest> 


实例 FileDemo 中 的 FileDemo java 代码 如 下 : 


public class FileDemo extends Activity { 
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private EditText SaveText; 
private Button SaveButton, LoadButton; 


QGOverride 
public void onCreate (Bundle savedInstanceState) ( 


super.onCreate (savedInstanceState) ; 
setContentView (R.layout.main) ; 

SaveText- (EditText) findViewById (R.id.phone text) 
SaveButton- (Button) findViewById (R.id.SaveButton) 
LoadButton- (Button) findViewById (R.id.LoadButton) ; 
SaveButton.setOnClickListener (new ButtonListener()) 
LoadButton.setOnClickListener (new ButtonListener()) 


} 
private class ButtonListener implements OnClickListener{ 


GOverride 
public void onClick (View v) ( 
switch (v.getId()) ( 
/* 保 存 数据 */ 
case R.id.SaveButton: 
String saveinfo-SaveText.getText().toString().trim(); 
FileOutputStream fos; 


try ( 
fos-openFileOutput ("text", MODE APPEND) ; 


fos.write (saveinfo.getBytes()) ; 
fos.close(); 

} catch (Exception e) { 
e.printStackTrace(); 


) 
Toast.makeText (FileDemo.this, "数据 保存 成 功 " ,Toast .LENGTH_LONG) . 
show(); 
break; 
/* 读 取 数据 */ 
case R.id.LoadButton: 
String get=""; 


try { 
FileInputStream fis=openFileInput ("text") ; 


byte [] buffer=new byte[fis.available()]; 
fis.read (buffer) ; 
get=new String (buffer) ; 
} catch (Exception e) { 
e.printStackTrace(); 


} 
Toast .makeText (FileDemo.this, "保存 的 数据 是 : "+get， 


Toast.LENGTH LONG) .show() ; 
break; 
default: 
break; 
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/ 。 3 SQLite 


前 面 我 们 介绍 了 用 SharedPreferences 和 文件 存储 信息 的 方法 ， 但 是 当 频 繁 大 量 地 使 用 
数据 存储 时 ， 就 要 用 到 数据 库 来 管理 信息 数据 了 。 在 Android 中 我 们 使 用 SQLite 数据 库 ， 
在 应 用 中 也 常常 会 用 到 SQLite 来 存储 、 管 理 、 维 护 数据 ， 本 节 将 详细 介绍 SQLite 的 使 用 
方法 。 


7.3.1 SQLite 数据 库 简 介 


Android 通过 SQLite 数据 库 引 擎 来 实现 结构 化 数据 存储 。Android 系统 提供 对 SQLite 数 
据 库 的 完全 支持 ， 在 数据 库 应 用 程序 中 ， 任 何 类 都 可 以 通过 名 字 对 已 创建 的 数据 库 进行 访 
问 ， 但 是 在 应 用 程序 之 外 不 可 以 。 

SQLite 是 一 个 轻 量 级 数据 库 ， 第 一 个 版 本 诞生 在 2000 年 5 月， 其 遵守 ACID 的 关联 式 数 
据 库 管理 系统 ， 最 初 就 是 为 嵌入 式 设 计 的 ， 其 占用 资源 非常 地 低 ， 在 内 存 中 只 需要 占用 几 
H KB 的 存储 空间 ， 这 也 是 Android XJ] SQLite 数据 库 的 重要 原因 之 一 。 同 时 SQLite 还 支持 
事务 处 理 功能 ， 根 据 相 关 资 料 可 知 SQLite 的 处 理 速度 比 MySQL. PostgreSQL 等 著名 的 开源 
数据 库 管理 系统 更 快 。 另 外 ，SQLite 数据 库 不 像 其 他 的 数据 库 ( 如 Oracle) ， 它 没有 服务 器 
HEFE, SQLite 通过 文件 保存 数据 库 ， 该 文件 是 跨 平 台 的 ， 可 以 自由 复制 。 一 个 文件 就 是 一 个 
数据 库 ， 数 据 库 名 称 即 文件 名 ; 数据 库 里 面 可 以 包含 多 个 表格 ， 在 每 个 表格 中 可 以 添加 多 条 
记录 ， 但 记录 没有 名 称 ; 记录 可 以 由 多 个 字段 组 成 ， 每 个 字段 都 要 有 相对 应 的 值 ， 每 个 值 都 
必须 指定 类 型 。 基 于 SQLite 自身 的 先天 优势 ， 其 在 嵌入 式 领 域 中 得 到 了 广泛 应 用 。 

SQLite 支 持 SQL 语言 ， 由 SQL 编译 器 、 内 核 、 后 端 以 及 附件 组 成 。SQLite 通过 利用 虚 
拟 机 和 虚拟 数据 库 引 擎 (VDBE) ， 使 调试 、 修 改 和 扩展 SQLite 的 内 核 变 得 更 加 方便 。 

Android 在 运行 时 (run-time) 集成 了 SQLite， 所 以 每 个 Android 应 用 程序 都 可 以 使 用 
SQLite 数据 库 ， 在 Android 开发 中 使 用 SQLite 相当 简单 。 但 是 ， 由 于 JDBC 会 消耗 太 多 的 系 
统 资源 ， 所 以 JDBC 对 于 手机 这 种 内 存 受 限 设备 来 说 并 不 合适 。 因 此 ，Android 提供 了 一 些 新 
的 API 来 使 用 SQLite 数据 库 ，Android 开发 中 我 们 需要 学 习 使 用 这 些 API。 另 外 需要 了 解 的 
是 ， 数 据 库存 储 在 data/< 项 目 文件 夹 >/databases/ 目 录 下 。 

操作 SQLite 数据 的 步骤 如 下 : 


E) 创建 SQLite AHF. Android 系统 推荐 的 创建 SQLite 数据 库 的 方法 是 创建 实现 了 
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SQLiteOpenHelper 接 口 的 子 类 ， 并 且 重 写 onCreate() 方 法 ， 在 该 方法 中 执行 用 于 创 
建 SQLite 数据 库 的 命令 。 所 创建 的 数据 库 被 放置 在 /data/data/<your package name> 
/database 目录 下 。 例 如 : 


public class DictionaryOpenHelper extends SQLiteOpenHelper { 


private static final int DATABASE VERSION=2; 
private static final String DICTIONARY_TABLE_NAME="dictionary"; 
// 创 建 数据 库 的 SOL 语句 


private static final String DICTIONARY_TABLE_CREATE= 


ks 


ez 


7.3.2 


An 


"CREATE TABLE "+DICTIONARY_TABLE_NAME+" ("+ 
KEY_WORD+" TEXT, "+ 
KEY_DEFINITION+" TEXT) ;"; 
DictionaryOpenHelper (Context context) { 
super (context, DATABASE_NAME, null, DATABASE_VERSION) ; 
} 
@Override 
public void onCreate (SQLiteDatabase db) { 
db.execSQL (DICTIONARY TABLE CREATE) ; // 执 行 SQL 语句 
} 


获取 数据 库 对 象 。 通 过 实现 了 SQLiteOpenHelper 接口 的 类 的 对 象 ， 调 用 
getWritableDatabase() 和 getReadableDatabase() 方法 ， 可 以 返回 所 创建 数据 库 的 
SQLiteDatabase 对 象 。 

对 数据 库 进 行 操作 。SQLiteDatabase 对 象 提供 了 对 数据 库 进 行 操 作 的 一 系列 方法 ， 
例如 query. insert, delete, update 等 ， 进 而 对 SQLite 数据 库 进 行 读 写 等 操作 。 

对 数据 库 的 查询 操作 会 返回 一 个 Cursor 对 象 ， 通 过 该 对 象 可 以 从 返回 的 结果 中 读 取 
出 行 、 列 信息 。 


SQLite 数据 库 操作 
driod 提供 了 创建 和 使 用 SQLite 数据 库 的 API. Android SDK 提供 了 一 系列 对 SQLite 


数据 库 进行 操作 的 类 和 接口 ， 这 里 我 们 简单 介绍 一 下 。 


SQLiteDatabase 类 。SQLiteDatabase 是 一 个 数据 库 访问 类 ， 此 类 封装 了 一 系列 数据 库 
操作 的 API， 使 其 可 以 对 数据 进行 CRUD 操作 ， 即 添加 、 查 询 、 更 新 、 删 除 等 。 一 些 
常用 的 操作 数据 库 的 方法 如 表 7.1 所 示 。 


表 7.1 SQLiteDatabase 常用 方法 


方法 名 称 方法 描述 


openOrCreateDatabase (String path.SQLiteDatabase.CursorFactory factory ) 打开 或 创建 数据 库 
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( 续 表 ) 
方法 名 称 方法 描述 
insert (String table,String nullColumnHack.ContentValues values) 添加 一 条 记录 
delete (String table,String whereClause.String[] whereArgs) 删除 一 条 记录 


query (String table, String[] columns, String selection, String[] selectionArgs, 


String groupBy.String having.String orderBy) stdiusa: 
update (String table.ContentValues values,String whereClause,String[] whereArgs) 修改 记录 

execSQL (String sql) 执行 一 条 SQL 语句 
close() 关闭 数据 库 


© SQLiteOpenHelper X. SQLiteOpenHelper 是 一 个 抽象 类 ， 用 来 创建 和 版 本 更 新 。 
SQLiteOpenHelper 的 子 类 通过 getReadableDatabase()fe getWritableDatabase() 方 法 来 获 
取 SQLiteDatabase 实例 对 象 ， 并 保证 以 同步 方式 访问 。 通 常情 况 下 getReadableDatabase() 
和 getWritableDatabase() 都 是 创建 或 者 打开 一 个 可 写 数 据 库 ， 并 返回 相同 的 对 象 。 只 
有 在 某 些 情况 下 ， 例 如 磁盘 空间 满 了 ， 或 者 数据 库 只 能 以 只 读 方式 打开 的 时 候 ， 
getReadableDatabase() 方 法 才 会 以 查询 方式 打开 数据 库 。 其 一 般 的 用 法 是 定义 一 个 类 
继承 之 ， 并 实现 其 抽象 方法 来 创建 和 更 新 数据 库 ， 其 常见 的 方法 如 表 7.2 所 示 。 


37.2 SQLiteOpenHelper 常用 方法 


方法 名 称 方法 描述 

SQLiteOpenHelper ( Context contextString name, | 构造 方法 ， 一 般 是 要 传递 一 个 要 创建 的 数据 库 名 称 
CursorFactory factory, int version) name 参数 

上 ( SQLiteDatabase db,int oldVersion.int 版 本 更 新 时 调用 

newVersion) 

getReadableDatabase() 创建 或 打开 一 个 只 读数 据 库 

getWritableDatabase() 创建 或 打开 一 个 读 写 数 据 库 


* Cursor 接口 。Cursor 是 一 个 游标 接口 ， 


在 数据 库 使 用 中 作为 返回 值 ， 相 当 于 结果 集 


ResultSet。 它 提供 了 遍历 查询 结果 的 方法 。Cursor 游标 的 一 些 常用 方法 如 表 7.3 所 示 。 


#7.3 ”Cursor 游 标 常用 方法 
方法 描述 
关闭 游标 ， 释 放 资 源 


在 缓冲 区 中 检索 请 求 的 列 的 文本 ， 并 将 其 存 
储 


返回 所 有 列 的 总 数 


方法 名 称 


close() 


copyStringToBuffer (int columnIndex. CharArrayBuffer 
buffer) 


getColumnCount() 
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K) 
方法 名 称 方法 描述 
getColumnIndex (String columnName) 返回 指定 列 的 名 称 ， 如 果 不 存在 返回 -1 
getColumnIndexOrThrow (String columnName) ew NER, WRT 
getColumnName (int columnIndex) 从 给 定 的 索引 返回 列 名 
getColumnNames() 返回 一 个 字符 串 数 组 的 列 名 
getCount() 返回 Cursor 中 的 行 数 
moveToFirst() 移动 光标 到 第 一 行 
moveToLast() 移动 光标 到 最 后 一 行 
moveToNext() 移动 光标 到 下 一 行 
moveToPosition (int position) 移动 光标 到 一 个 绝对 的 位 置 
moveToPrevious() 移动 光标 到 上 一 行 


这 些 方法 的 使 用 可 以 通过 创建 数据 库 、 创 建 表 和 执行 SQL 语句 的 过 程 进 行 一 一 介绍 。 


人 RON) 打开 或 创建 数据 库 。openOrCreateDatabase() 方 法 会 自动 检测 要 打开 的 数据 库 是 否 存 
在 ， 如 果 存 在 则 打开 ， 不 存在 则 创建 一 个 数据 库 。 该 方法 运行 成 功 则 返回 一 个 
SQLiteDatabase 对 象 ， 否 则 抛 出 异常 FileNotFoundException。 下 面 为 创建 数据 库 名 
为 “sie.db” 的 数据 库 代 码 : 


SQLiteDatabase database-SQLiteDatabase.openOrCreateDatabase 
("/data/data/sie.db",null) ; 


E 创建 数据 表 。 使 用 SQLiteDatabase 的 execSQL() 方 法 来 执行 SQL 语句 便 能 创建 一 个 
表 。 下 面 创 建 一 个 表 ， 其 中 有 三 个 属性 : id 为 主键 并 自动 增加 ，name 为 姓名 ， 
number 为 编号 ， 相 关 代 码 如 下 : 

String table="create table sietexttable (_id integer primary key 
autoincrement, 


name text, number text) "; 
database.execSQL (table) ; 


CX303 插入 数据 。 使 用 SQLiteDatabase 的 insert ( String table,String nullColumnHack, 
ContentValues values) 方法 ， 第 一 个 参数 是 表 名 称 ， 第 二 个 参数 是 空 列 的 默认 值 ， 
第 三 个 是 ContentValues 封装 的 列 的 名 称 和 对 应 的 列 值 ， 代 码 如 下 : 
ContentValues values-new ContentValues(); 
values.put ("name", "sietext01") ; 


values.put ("number", "001") ; 
database.insert ("table", null, values) ; 
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Eo MRA, IŻ SQLiteDatabase 的 delete ( String table.String whereClause,String[] 
whereArgs ) 方法 ， 第 一 个 参数 是 表 的 名 称 ， 第 二 个 参数 是 删除 条 件 ， 第 三 个 参数 
是 条 件 值 数组 。 
€s 修改 数据 。 使 用 SQLiteDatabase 的 update ( String table,ContentValues values,String 
whereClause, String[] whereArgs ) 方法 ， 第 一 个 参数 是 表 名 称 ， 第 二 个 参数 是 更 新 
行 和 列 的 ContentValues 类 型 的 键 值 对 ， 第 三 个 参数 是 更 新 条 件 ， 第 四 个 参数 是 更 
新 的 条 件数 组 。 此 外 ， 上 述 三 种 能 够 引起 数据 库 数据 改变 的 操作 ， 都 可 以 通过 
SQLiteDatabase 的 execSQL() 方 法 来 完成 。 
€X06 查询 数据 ,在 Android 中 通过 Cursor 类 来 实现 ,使 用 SQLiteDatabase.query() 方 法 会 
得 到 一 个 Cursor 对 象 ，Cursor 用 于 指向 查询 结果 中 的 记录 。 下 面 是 使 用 Cursor 查 
询 数 据 库 中 的 数据 ， 代 码 如 下 : 
Cursor cursor=database.query ("table", null, null, null, null, null, 
null) ; 
/* 判 断 游标 是 否 为 空 */ 
if (cursor.moveToFirst()) { 


for (int i=0;i<cursor.getCount();i++) { 
cursor.moveToNext () ; 
// 获 得 ID 
int id=cursor.getInt (0) ; 


// 获 得 用 户 名 


String name=cursor.getString (1) ; 


// 获 得 编号 
String number=cursor.getString (2) ; 


3 


SQLiteOpenHelper 类 是 SQLiteDataBase 的 帮助 类 ， 这 个 类 主要 用 于 打开 或 者 创建 数据 
库 ， 并 返回 数据 库 对 象 ， 同 时 对 数据 库 的 版 本 进行 管理 。 并 且 它 是 一 个 抽象 类 ， 需 要 继承 它 
并 实现 里 面 的 两 个 抽象 方法 : 
* onCreate ( SQLiteDatabase) 。 在 数据 库 第 一 次 生成 的 时 候 会 调用 这 个 方法 ， 一 般 在 这 
个 方法 里 边 生 成 数据 库 表 。 
© onUpgrade ( SQLiteDatabase intint) 。 当 数据 库 需 要 升级 的 时 候 ， 系 统 会 主动 调用 这 
个 方法 。 一 般 在 这 个 方法 里 边 删除 原 有 数据 表 ， 并 建立 新 的 数据 表 。 


7.8.3 SQLite 数据 库 操作 实例 


实例 MyDbDemo 演示 了 使 用 SQLiteOpenHelper 和 SQLiteDatabase 对 数据 库 进行 操作 的 
过 程 ， 其 运行 效果 如 图 7.3 所 示 。 
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7.3 MyDbDemo 界面 


实例 MyDbDemo 使 用 SQLiteOpenHelper 对 象 建立 了 数据 库 文 件 “mydb”， 通 过 
SQLiteDatabase 对 象 对 该 数据 库 进行 了 数据 的 查询 、 插 入 、 修 改 和 删除 操作 ， 并 显示 到 
ListView 组 件 中 。 

实例 MyDbDemo 的 运行 界面 实际 上 由 两 个 xml 文件 组 成 ， 分 别 是 main.xml 和 
listview.xml。 其 中 main.xml 文件 的 代码 如 下 : 


<?xml version="1.0" encoding-"utf-8"?» 
<LinearLayout 
xmlns:android-"http://schemas.android.com/apk/res/android" 
android:layout width-"fill parent" 
android:layout height-"fill parent" 
android:orientation-"vertical"» 


«LinearLayout 
android:layout width-"fill parent" 
android:layout height-"wrap content" 
android:addStatesFromChildren-"true"'» 


«TextView 

android:layout width-"wrap content" 

android:layout height-"wrap content" 

android: text="%#4%" 

android: textColor="?android:attr/textColorSecondary" /> 
<EditText 

android: id="@+id/et_name" 

android: layout_width="wrap_content" 
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android: layout_height="wrap_content" 
android: layout_weight="1" 
android:singleLine="true" /> 
</LinearLayout> 
<LinearLayout 
android:layout width-"fill parent" 
android:layout height-"wrap content" 
android:addStatesFromChildren-"true"'» 
«TextView 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:text=" 年 龄 " 
android:textColor-"?android:attr/textColorSecondary" /> 
<EditText 
android:id="@+id/et_age" 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:layout weight-"1" 
android:singleLine-"true" /» 
</LinearLayout> 
<LinearLayout 
android:layout width-"fill parent" 
android:layout height-"wrap content" 
android:addStatesFromChildren-"true" 
android:gravity-"center"» 
«Button 
android:id-"G«id/bt add" 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:text=" 添 加 " 
android:onClick-"addbutton"» 
</Button> 
<Button 
android: id="@+id/bt_modify" 
android: layout_width="wrap_content" 
android:layout height-"wrap content" 
android:text=" 修 改 " 
android:onClick="updatebutton"> 
</Button> 
<Button 
android:id="@+id/bt_del" 
android: layout_width="wrap_content" 
android: layout_height="wrap_content" 
android:text=" 删 除 " 
android:onClick="updatebutton"> 
</Button> 
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<Button 
android: id="@+id/bt_query" 
android: layout_width="wrap_content" 
android:layout height-"wrap content" 
android:text-"7rifj" 
android:onClick-"querybutton"» 
«/Button» 
</LinearLayout> 
<ListView 
android: id="@+id/listView" 
android:layout width-"fill parent" 
android:layout height-"wrap content" 
android:padding-"5dip"» 
«/ListView» 
</LinearLayout> 


由 代码 可 见 ，main.xml 实际 上 实现 的 是 如 图 7.4 所 示 效 果 。 该 布局 中 放置 了 两 个 
TextView、 两 个 EditText 和 四 个 按钮 ， 然 后 在 按钮 的 下 面 是 一 个 ListView 组 件 ， 但 是 该 
ListView 没有 对 显示 效果 进行 任何 的 限制 。 


图 7.44 main.xml 界面 


实例 MyDbDemo 中 的 listview.xml 文件 代码 如 下 : 


<?xml version="1.0" encoding-"utf-8"?» 
<LinearLayout 
xmlns:android-"http://schemas.android.com/apk/res/android" 
android:id-"e«id/linear" 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:padding-"5dip"» 
«TextView 
android: id="@+id/tvID" 
android: layout_width="80dp" 
android: layout_height="wrap_content"/> 
<TextView 
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android: id="@+id/tvName" 

android: layout_width="80dp" 

android: layout_height="wrap_content"/> 
<TextView 

android: id="@+id/tvAge" 

android: layout_width="80dp" 

android:layout height-"wrap content" /> 


«/LinearLayout» 


可 见 listview.xml 布局 中 横向 放置 了 三 个 TextView 用 于 显示 数据 。 该 实例 实际 的 运行 效 
果 是 使 用 listview.xml 中 的 数据 格式 替换 了 main.xml 中 ListView 组 件 的 数据 格式 后 实现 的 。 
该 效果 通过 LayoutInflater 类 的 对 象 进行 实现 。 

实例 MyDbDemo 中 AndroidManifest.xml 文件 的 代码 如 下 : 


<?xml version="1.0" encoding="utf-8"?> 
«manifest xmlns:android="http://schemas.android.com/apk/res/android" 
package="introduction.android.mydbDemo" 
android: versionCode="1" 
android: versionName="1.0"> 
<uses-sdk android:minSdkVersion="14" /> 
<application 
android: icon="@drawable/ic_launcher" 
android: label="@string/app_name"> 
<activity 
android: label="@string/app_name" 
android:name=".MyDbDemoActivity"> 
<intent-filter> 
<action android:name="android.intent.action.MAIN" /> 
<category 
android:name="android.intent.category. LAUNCHER" /> 
</intent-filter> 
</activity> 
</application> 


</manifest> 


实例 MyDbDemo 中 SQLiteOpenHelper 的 子 类 dbHelper 的 实现 代码 如 下 : 


package introduction.android.mydbDemo; 

import android.content.Context; 

import android.database.sqlite.SQLiteDatabase; 

import android.database.sqlite.SQLiteDatabase.CursorFactory; 
import android.database.sqlite.SQLiteOpenHelper; 


public class dbHelper extends SQLiteOpenHelper( 
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public static final String TB NAME-"friends"; 
public dbHelper (Context context, String name, CursorFactory factory, 
int version) { 
super (context, name, factory, version) ; 
// TODO Auto-generated constructor stub 
4 
@Override 
public void onCreate (SQLiteDatabase db) { 
// TODO Auto-generated method stub 
db.execSQL ("CREATE TABLE IF NOT EXISTS "+ 
TB_NAME+" ( _id integer primary key 
autoincrement, "+// 
"name varchar, "+ 
"age integer"+ 
OO R 
3 
@Override 
public void onUpgrade (SQLiteDatabase db, int oldVersion, int 
newVersion) { 
// TODO Auto-generated method stub 
db.execSQL ("DROP TABLE IF EXISTS "+TB_NAME) ; 
onCreate (db) ; 


FH dbHelper 5 f 4225 SQLiteOpenHelper 的 两 个 抽象 方法 onCreate() fll onUpgrade(). 
TE onCreate0 方 法 中 创建 了 一 个 名 为 friends 的 数据 表 ， 该 数据 表 有 _id、name 和 age 三 个 字 
段 ， 其 中 _id 为 自 增加 主键 。onUpgrade0 方 法 实现 了 删除 现 有 数据 表 并 且 重 建 的 功能 。 

实例 MyDbDemo 中 的 主 Activity 所 对 应 文件 MyDbDemoActivityjava 代码 如 下 : 


package introduction.android.mydbDemo; 

import introduction.android.mydbDemo.dbHelper; 
import introduction.android.mydbDemo.R; 

import java.util.ArrayList; 

import java.util.HashMap; 

import java.util.Map; 

import android.app.Activity; 

import android.content.ContentValues; 

import android.database.Cursor; 

import android.database.sqlite.SQLiteDatabase; 
import android.os.Bundle; 

import android.util.Log; 

import android.view.View; 

import android.widget.AdapterView; 

import android.widget.Button; 
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android.widget.EditText; 
android.widget.ListView; 
android.widget.SimpleAdapter; 
android.widget.TextView; 

android.widget.Toast; 
android.widget.AdapterView.OnItemClickListener; 
class MyDbDemoActivity extends Activity ( 


private static String DB NAME-"mydb"; 


private EditText et name; 


private EditText et age; 

private ArrayList<Map<String, Object>>data; 

private dbHelper dbHelper; 

private SQLiteDatabase db; 

private Cursor cursor; 

private SimpleAdapter listAdapter; 

private View view; 

private ListView listview; 

private Button selBtn,addBtn,updBtn,delBtn; 

private Map<String, Object>item; 

private String selld; 

private ContentValues selCV; 

/** Called when the activity is first created. */ 
GOverride 
public void onCreate (Bundle savedInstanceState) { 


super.onCreate (savedInstanceState) ; 
setContentView (R.layout.main) ; 
et name- (EditText) findViewById (R.id.et name) ; 
et age- (EditText) findViewById (R.id.et age) ; 
listview- (ListView) findViewById (R.id.listView) ; 
selBtn- (Button) findViewById (R.id.bt query) ; 
addBtn- (Button) findViewById (R.id.bt add) ; 
updBtn- (Button) findViewById (R.id.bt modify) ; 
delBtn- (Button) findViewById (R.id.bt del) ; 
selBtn.setOnClickListener (new Button.OnClickListener()( 

GOverride 

public void onClick (View v) ( 

// TODO Auto-generated method stub 


dbFindAll(); 
} 
0; 
addBtn.setOnClickListener (new Button.OnClickListener()( 
@override 


public void onClick (View v) { 
// TODO Auto-generated method stub 
dbAdd () ; 
dbFindAll(); 
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D; 
updBtn.setOnClickListener (new Button.OnClickListener () { 
@override 
public void onClick (View v) { 
// TODO Auto-generated method stub 
dbUpdate (); 
dbFindAll(); 
} 
); 
delBtn.setOnClickListener (new Button.OnClickListener () { 
@Override 


public void onClick (View v) { 
// TODO Auto-generated method stub 
dbDel () ; 
dbFindAll(); 


1275 
dbHelper-new dbHelper (this, DB NAME, null, 1) ; 
db-dbHelper.getWritableDatabase();// 打开 数据 库 
data-new ArrayList<Map<String,Object>>(); 
dbFindAll(); 
listview.setOnItemClickListener (new OnItemClickListener()( 
@Override 
public void onItemClick (AdapterView<?>parent, View v, 
int position, long id) { 
// TODO Auto-generated method stub 
Map<String, Object>listItem= (Map<String,Object>) 
listview.getItemAtPosition (position) ; 
et_name.setText ( (String) listItem.get 
("name") ) ; 
et_age.setText ( (String) listItem.get ("age") ) ; 
selld- (String) listItem.get ("_id") ; 
Log.i ("mydbDemo", "id="+selId) ; 


); 


} 
// 数 据 删除 
protected void dbDel() { 
// TODO Auto-generated method stub 
String where="_id="+selId; 
int i=db.delete (dbHelper.TB_NAME, where, null) ; 
if (i>0) 
Log.i ("myDbDemo", "数据 删除 成 功 ! ") ; 
else 


Log.i ("myDbDemo", "数据 未 删除 ! ") ; 
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l 
// 更 新 列表 中 的 数据 
private void showList() { 
// TODO Auto-generated method stub 
listAdapter=new SimpleAdapter (this,data, 
R.layout.listview, 
new String[](" id","name","age"], 
new int[](R.id.tvID,R.id.tvName,R.id.tvAge)) ; 
listview.setAdapter (listAdapter) ; 


} 
// 数 据 更 新 
protected void dbUpdate() { 
// TODO Auto-generated method stub 
ContentValues values=new ContentValues(); 
values.put ("name", et name.getText().toString().trim()) ; 
values.put ("age", et age.getText().toString().trim()) ; 
String where-" id-"-«selld; 
int i-db.update (dbHelper.TB NAME, values, where, null) ; 
if (i»0) 
Log.i ("myDbDemo", "数据 更 新 成 功 ! ") ; 
else 
Log.i ("myDbDemo" , "数据 未 更 新 ! ") ; 


} 
// 插 入 数据 
protected void dbAdd() { 
// TODO Auto-generated method stub 
ContentValues values=new ContentValues(); 
values.put ("name", et name.getText().toString().trim()) ; 
values.put ("age", et age.getText().toString().trim()) ; 
long rowid-db.insert (dbHelper.TB NAME, null, values) ; 
if (rowid---1) 
Log.i ("myDbDemo"，。" 数 据 插入 失败 ! ") ; 
else 
Log.i ("myDbDemo", "数据 插入 成 功 ! "+rowid) ; 


} 
// 查 询 数据 
protected void dbFindAll(){ 
// TODO Auto-generated method stub 
data.clear(); 
cursor-db.query (dbHelper.TB NAME, null, null, null, null, 
puil, = id ASC"); 
cursor.moveToFirst(); 
while (!cursor.isAfterLast()) ( 
String id-cursor.getString (0) ; 
String name-cursor.getString (1) ; 
String age-cursor.getString (2) ; 
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item-new HashMap<String, Object>(); 
item put Cu td", dd). 
item.put ("name", name) ; 
item.put ("age", age) ; 
data.add (item) ; 
cursor .moveToNext () ; 
} 
showList (); 


} 


MyDbDemoActivity 在 onCreate() 方 法 中 调用 dbHelper 创建 了 数据 库 文件 “mydb”， 并 
获取 到 该 数据 库 的 可 写 SQLiteDatabase 对 象 ， 并 将 数据 库 中 所 有 的 数据 显示 到 listview 中 。 
MyDbDemoActivity 为 main.xml 中 的 四 个 按钮 分 别 添加 按钮 单 击 监视 器 并 进行 处 理 ， 通 过 
SQLiteDatabase 对 象 实现 了 对 数据 库 的 CRUD 操作 。 

其 中 H 


listAdapter-new SimpleAdapter (this,data, 
R.layout.listview, 
new String[](" id","name","age"), 
new int[](R.id.tvID,R.id.tvName,R.id.tvAge)) ; 
listview.setAdapter (listAdapter) ; 


这 几 行 代码 通过 SimpleAdapter Xf listview.xml 文件 中 定义 的 TextView 组 件 与 main.xml 中 
的 ListView 组 件 进行 关联 ， 这 样 就 使 main.xml 中 的 ListView 组 件 以 listview.xml 文件 中 定义 
的 格式 将 数据 显示 出 来 。 


cursor-db.query (dbHelper.TB NAME, null, null, null, null, null, 
" id ASC") ; 

cursor.moveToFirst(); 

while (!cursor.isAfterLast()) ( 
String id-cursor.getString (0) ; 
String name-cursor.getString (1) ; 
String age-cursor.getString (2) ; 
item=new HashMap«String,Object»(); 
item.put (" id", id) ; 
item.put ("name", name) ; 
item.put ("age", age) ; 
data.add (item) ; 
cursor.moveToNext () ; 

} 


这 几 行 代码 从 friends 数据 表 中 查询 出 所 有 数据 ， 并 按 _id 升序 排列 。cursorgetString( 方 
法 按照 列 将 每 条 数据 的 对 应 字段 分 别 取出 来 ， 通 过 while 循环 将 所 有 数据 保存 到 data 中 。 
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listview.setOnItemClickListener (new OnItemClickListener () { 
@override 
public void onItemClick (AdapterView<?>parent, View v, 
int position, long id) { 
// TODO Auto-generated method stub 


Map<String, Object>listItem= (Map<String, Object>) 
listview.getItemAtPosition (position) ; 
et_name.setText ( (String) listItem.get 
("name") ) ; 
et age.setText ( (String) listItem.get ("age") ) ; 
selld- (String) listItem.get (" id") ; 
Log.i ("mydbDemo", "id="+selId) ; 


): 


这 几 行 代码 为 ListView 组 件 添 加 了 单 击 监听 器 ， 并 对 单 击 事件 进行 了 处 理 。 当 用 户 单 击 
ListView 组 件 中 的 某 条 数据 时 ， 将 该 条 数据 的 name 和 age 字段 显示 到 main.xml 文件 中 的 
EditText 中 ， 并 将 该 记录 的 “ id” 值 存储 到 selld 中 ， 以 便于 对 该 条 记录 进行 操作 。 

实例 MyDbDemo 中 对 数据 库 的 CRUD 操作 分 别 通过 SQLiteDatabase 对 象 的 query. 
insert、update、delete 方法 实现 ， 此 处 不 再 描述 。 


/ a 4. ContentProvider 


7.4.1 ContentProvider 简介 


ContentProvider 是 Android 的 四 大 组 件 之 一 ， 用 于 保存 和 检索 数据 ， 是 Android 系统 中 不 
同 应 用 程序 之 间 共 享 数据 的 接口 。 在 Android 系统 中 ， 应 用 程序 之 间 是 相互 独立 的 ， 分 别 运 
行 在 自己 的 进程 中 ， 相 互 之 间 没 有 数据 交换 。 若 应 用 程序 之 间 需 要 共享 数据 ， 就 要 用 到 
ContentProvider。 在 Android 系统 的 手机 中 ，ContentProvider 的 最 典型 应 用 是 当 发 送 一 条 短信 
时 需要 用 到 联系 人 的 相关 信息 ， 此 时 就 是 通过 ContentProvider 提供 的 接口 访问 Android 系统 
中 的 电话 每 ， 并 从 中 选择 联系 人 。 

ContentProvider 提供 了 一 组 应 用 程序 之 间 能 相互 访问 的 接口 。 应 用 程序 通过 ContentProvider 
把 当前 应 用 中 的 数据 共享 给 其 他 应 用 程序 访问 ， 而 其 他 应 用 程序 通过 ContentProvider 对 指定 
应 用 中 的 数据 进行 访问 和 操作 。 

Android 系统 对 一 系列 常见 的 公用 数据 类 型 提供 了 对 应 的 ContentProvider 接口 ， 例 如 视 
频 、 音 频 、 图 像 、 个 人 通讯 信息 等 ， 都 定义 在 android provider & F. 
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若 应 用 程序 开发 者 想 将 自己 的 数据 公开 给 其 他 应 用 程序 使 用 ， 有 两 种 方法 : 一 种 是 定义 
自己 的 ContentProvider 子 类 ， 另 外 一 种 是 将 当前 应 用 程序 的 数据 添加 到 已 有 的 ContentProvider 
中 。 

ContentProvider 中 的 数据 在 形式 上 和 关系 数据 库 中 的 表格 很 相似 。 以 Android 系统 内 建 
的 用 户 常 用 词典 所 对 应 的 ContentProvider 为 例 ，Android 系统 为 其 定义 的 名 字 为 android. 
provider.UserDictionary， 该 用 户 词 典 中 的 word 表格 记录 了 特定 用 户 经 常 使 用 的 不 规则 单 次 的 
相关 信息 。 其 数据 格式 如 表格 7.4 所 示 。 


3& 7.4 ContentProvider 数据 格式 


表 头 部 分 存储 在 ContentProvider 中 ， 表 格 的 每 一 行 是 该 词典 数据 的 一 个 实例 ， 也 就 是 一 
个 非 标准 的 单词 ， 每 一 列 是 和 该 单词 相关 的 一 些 信息 ， 例 如 该 单词 的 拼写 、 使 用 者 的 id、 使 
用 频率 等 ，_ID 起 到 了 主键 的 作用 。 

应 用 程序 通过 ContentResolver 的 对 象 访问 ContentProvider 中 的 数据 ， 该 对 象 提供 了 对 持 
久 层 数据 的 CRUD 方法 。 每 个 Activity 都 有 一 个 ContentResolver 对 象 ， 要 获取 该 对 象 ， 可 以 
使 用 Activity 提供 的 getContentResolver() 方 法 。 当 然 ， 应 用 程序 要 使 用 其 他 应 用 程序 提供 的 
ContentProvider 需要 拥有 进行 操作 的 相应 权限 。 所 有 用 户 词典 数据 的 代码 为 : 


mCursor=getContentResolver() .query ( 
UserDictionary.Words.CONTENT URI,null,null,null,null) 


其 所 对 应 权限 为 : android.permissionREAD_USER_DICTIONARY， 因 此 必须 在 应 用 程序 
的 AndroidMainfest.xml 文件 中 添加 : 


<uses-permission 
android:name="android.permission.READ_USER_DICTIONARY"> 


UserDictionary.Words.CONTENT_URI 指 的 是 用 户 词 典 中 words #1 A 2€ URI. 
ContentProvider 通过 URI 来 共享 数据 。URI 是 一 个 通用 资源 标志 符 ， 可 将 其 分 为 A， 
B，C，D 共 4 个 部 分 。 
eA: 无 法 改变 的 标准 前 缓 ， 包 括 : “content://” .  *tel//^ F. SAAR “content://” 
时 ， 说 明 在 通过 一 个 ContentProvider 控制 这 些 数据 。 
* B: URI 的 授权 部 分 ， 一 般 为 ContentProvider 的 全 称 ， 它 通过 Android:authorities 属性 
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声明 ， 用 于 说 明 是 哪个 ContentProvider 类 提供 这 些 数据 ， 必 须 全 部 由 小 写字 母 组 成 。 
如 : content://introduction.android.myprovider. 

e C: 路 径 ， 可 以 理解 为 需要 操作 的 数据 库 中 表 的 名 字 ， 如 : “content:// introduction. 
android.myprovider /name” 中 的 name. 

* D: 如 果 URI 中 包含 表示 需要 获取 记录 的 ID， 则 返回 该 ID 对 应 的 数据 ， 如 果 没 有 
ID， 就 表示 返回 全 部 数据 。 如 : content:// introduction.android.myprovider /name /01 。 


在 本 实例 中 ，UserDictionary .Words.CONTENT_URI 包 含 了 所 要 访问 ContentProvider 的 标 
识 和 具体 信息 表 的 路 径 。 其 所 代表 的 完整 的 字符 串 是 “content://user_dictionary/ words”， 其 
中 “content://” 是 前 置 格式 字符 串 ， 即 A 部 分 ，“user_ dictionary ”指定 了 提供 数据 的 
ContentProvider， 即 B 部 分 ，“words” 指 定 了 要 访问 的 数据 表 ， 即 C 部 分 。 

此 外 ，ContentProvider 允许 通过 在 URI 后 面 添加 WD 值 的 方式 访问 数据 表 中 某 一 列 数 
据 ， 即 添加 DD 部 分 。 例 如 ， 访 问 用 户 词典 words 表 中 _ID=2 的 数据 的 URI 可 以 这 样 表示 : 


Uri singleUri-ContentUri.withAppendedId ( 
UserDictionary.Words.CONTENT URI,2) ; 


其 对 应 的 完整 URI 为 : =“ content://user_dictionary/words/2” . 
ContentProvider 定义 在 android.content 包 下 面 ， 是 一 个 抽象 类 。 定 义 一 个 Content 
Provider 必须 实现 下 面 几 个 抽象 方法 。 


* onCreate(): 该 方法 用 于 在 启动 时 初始 化 ContentProvider。 由 于 该 方法 会 在 应 用 程序 的 
主线 程 启动 时 被 调用 ， 因 此 不 应 执行 耗 时 的 操作 ， 以 免 延 迟 应 用 程序 的 启动 时 间 。 执 
行 成 功 返 回 true， 失 败 返回 false. 

© query ( Uri,String[],String,String[],String ) : 该 方法 用 于 对 Uri 指定 的 ContentProvider 
进行 查询 ， 返 回 一 个 Cursor 对 象 。 

* insert ( Uri, ContentValues ) : 用 于 添加 数据 到 Uri 指定 的 ContentProvider 中 。 

© update ( Uri, ContentValues, String, String[] ) : 用 于 更 新 Uri 指定 的 ContentProvider 中 
的 数据 。 

* delete ( Uri, String, String[] ) : 用 于 从 Uri 指定 的 ContentProvider 中 删除 数据 。 

* getType (Uri) : 用 于 返回 Uri 指定 的 ContentProvider 中 的 数据 的 MIME 类 型 。 


ContentResolver 提供 的 方法 和 ContentProvider 提供 的 方法 相对 应 ， 主 要 有 以 下 几 个 方 
法 s 
* query ( Uri uri, String[] projection, String selection, String[] selectionArgs, String 
sortOrder) : 用 于 对 Uri 指定 的 ContentProvider 进行 查询 。 
* insert ( Uri uri, ContentValues values) : 用 于 添加 数据 到 Uri 指定 的 ContentProvider 
ie 
* delete ( Uri uri, String selection, String[] selectionArgs ) : 用 于 从 Uri 指定 的 ContentProvider 
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中 删除 数据 。 
* update ( Uri uri, ContentValues values, String selection, String[] selectionArgs ) : 用 于 更 
新 Uri 指定 的 ContentProvider 中 的 数据 。 


在 对 某 特 定 ContentProvider 的 CRUD 操作 中 ， 通 过 ContentResolver 提供 的 CRUD 方法 
将 相关 信息 传递 给 ContentProvider 所 提供 的 CRUD 方法 进而 对 数据 进行 操作 。 因 此 ， 在 定义 
自己 的 ContentProvider 时 ， 应 该 定义 好 该 ContentProvider 对 数据 进行 CRUD 操作 时 所 使 用 的 
方法 。 


7.4.2 UriMatcher 

Android 系统 提供 了 UriMatcher 类 用 于 对 URI 的 匹配 。 使 用 步骤 如 下 : 首先 创建 
UriMatcher 类 对 象 ， 然 后 通过 UriMatcher.addURI (String,String, int) 方法 对 其 增加 需要 匹配 
的 URI 路 径 ， 所 对 应 的 匹配 码 由 第 三 个 参数 指定 。 最 后 通过 UriMatcher.match (Uri) 方法 进 
行 匹 配 ， 并 返回 匹配 码 。 代 码 如 下 : 


UriMatcher uriMatcher=new UriMatcher (UriMatcher.NO_MATCH) ; 
// 构 建 UriMatcher 类 对 象 ， 常 量 UriMatcher.NO MATCH 表示 不 匹配 任何 路 径 ， 返 回 码 为 -1 
// 添 加 需要 匹配 的 URI， 并 指定 匹配 时 返回 的 匹配 码 
uriMatcher.addURI ("introdcuton.android.myprovider", "text", 1) ; 
/ ij match () 方 法 匹配 content: //introdcuton.android.myprovider/text 路 径 ， 
对 应 匹配 码 为 1 
uriMatcher.addURI ("introdcuton.android.myprovider", "text/#", 2); 
//# 号 为 通配符 ， 如 果 match () 方法 匹配 
content: //introdcuton.android.myprovider/text/230 
1/3848, XENA 2 
Uri uri-Uri.parse ("content://introdcuton.android.myprovider/text/10") ; 
switch (uriMatcher.match (uri) ) { 


case 1: // 匹 配 返 回 码 为 1 


// 执 行 相应 操作 
break; 
case 2: // 匹 配 返 回 码 为 2 
// 执 行 相应 操作 
break; 
default: ”// 不 匹配 
// 执 行 相应 操作 
break; 


} 


上 述 代码 中 ，uriMatcher.addURI ( "introdcuton.android.myprovider", "text/#", 2) 中 “#” 
为 通配符 ， 代 表 任 意 数字 ， 另 外 还 可 以 使 用 通配符 “*” 来 代表 任意 文本 。 这 句 话 表 示 若 传 入 
的 URI 能 够 匹配 “content://introdeuton.android.myprovider/text/ 数 字 ” 格 式 ， 则 返回 匹配 码 2. 
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7.4.3 ”访问 系统 提供 的 ContentProvider 


Android 系统 提供 了 很 多 ContentProvider， 以 便 在 应 用 程序 间 共 享 系统 数据 。 系 统 提 供 的 
ContentProvider 都 存放 在 android.provider 包 下 ， 例 如 : android.provider.ContactsContract 、 
android.provider.MediaStroe, android.provider.CalendarContract ^5 , 

本 节 以 访问 系统 联系 人 列表 为 例 ， 讲 解 如 何 通 过 系统 提供 的 ContentProvider 获取 数据 。 
在 Android 2.0 (API Level 5) 之 前 系统 所 提供 的 联系 人 ContentProvider 为 android.provider. 
Contacts， 从 Android 2.0 开始 ， 联 系 人 列表 相关 信息 被 存放 在 android.provider ContactsContract 
中 。 使 用 ContactsContract 获取 系统 联系 人 列表 的 方法 与 之 前 有 所 不 同 ， 虽 然 形式 上 较 以 前 复 
杂 了 一 点 ， 但 是 可 以 获取 一 个 联系 人 的 多 个 电话 号 码 。 

实例 ContactsCPDemo 演示 了 使 用 ContactsContract 获取 到 系统 中 所 有 联系 人 的 名 字 和 电 
话 号 码 ， 并 且 显 示 出 来 的 过 程 。 为 方便 起 见 ， 假 定 每 个 联系 人 仅 有 一 个 电话 号 码 ， 其 运行 效 
果 如 图 7.5 所 示 。 


Liu 
15555215556 


1 331-234-5678 


图 7.5 ContactsCPDemo 界面 
该 效果 由 ListView 组件 实 现 。 实 例 ContactsCPDemo 中 的 布局 文件 main.xml 代码 如 下 : 


<?xml version="1.0" encoding-"utf-8"?» 
<LinearLayout 
xmlns:android-"http://schemas.android.com/apk/res/android" 
android:layout width-"fill parent" 
android:layout height-"fill parent" 
android:orientation-"vertical"» 
«TextView 
android:layout width-"fill parent" 
android:layout height-"wrap content" 
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android:text=" 联 系 人 列表 如 下 : " /> 

<ListView 
android:id="@+id/listView" 
android:layout width-"fill parent" 
android:layout height-"wrap content" 
android:padding-"5dip"» 

«/ListView» 

</LinearLayout> 


实例 ContactsCPDemo 要 访问 系统 联系 人 列表 ， 需 要 拥有 “android.permission. READ -. 
CONTACTS” 权 限 。 实 例 ContactsCPDemo 中 的 AndroidManifest.xml 文件 代码 如 下 : 


<?xml version="1.0" encoding="utf-8"?> 
«manifest xmlns:android="http://schemas.android.com/apk/res/android" 
package="introduction.android.contacts" 
android: versionCode="1" 
android: versionName="1.0"> 
<uses-sdk android:minSdkVersion="14" /> 
<uses-permission android:name="android.permission.READ_CONTACTS"/> 
<application 
android: icon="@drawable/ic_launcher" 
android: label="@string/app_name"> 
<activity 
android: label="@string/app_name" 
android:name=".ContactsCPDemoActivity"> 
<intent-filter> 
<action android:name="android.intent.action.MAIN" /> 
<category 
android:name="android.intent.category.LAUNCHER" /> 
</intent-filter> 
</activity> 
</application> 
</manifest> 


实例 ContactsCPDemo 中 的 ContactsCPDemoActivity.java 文件 代码 如 下 : 


package introduction.android.contacts; 
import java.util.ArrayList; 

import java.util.HashMap; 

import java.util.Map; 

import android.app.Activity; 

import android.database.Cursor; 

import android.os.Bundle; 

import android.provider.ContactsContract; 
import android.widget.ListView; 

import android.widget.SimpleAdapter; 
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public class ContactsCPDemoActivity extends Activity { 
private SimpleAdapter listAdapter; 
private ListView listview; 
private ArrayList<Map<String, String>>data; 
private HashMap<String, String>item; 
/** Called when the activity is first created. */ 
@Override 
public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState) ; 
setContentView (R.layout.main) ; 
listview= (ListView) this. findViewById (R.id.listView) ; 
data-new ArrayList<Map<String, String>>(); 
Cursor cursor=this.getContentResolver () .query 
(ContactsContract.Contacts.CONTENT_URI, null, null, null, null) ; 
while (cursor.moveToNext()) { 
int idFieldIndex-cursor.getColumnIndex 
(ContactsContract.Contacts._ID) ; 
int id-cursor.getInt (idFieldIndex) ;// 根 据 列 名 取得 该 联系 人 的 
id; 
int nameFieldIndex-cursor.getColumnIndex 
(ContactsContract.Contacts.DISPLAY NAME) ; 
String name-cursor.getString (nameFieldIndex) ; 
// 根 据 列 名 取得 该 联系 人 的 name, 
int numCountFieldIndex-cursor.getColumnIndex 
(ContactsContract.Contacts.HAS_PHONE_NUMBER) ; 
int numCount=cursor.getInt (numCountFieldIndex) ; 
// 获 取 联系 人 的 电话 号 码 个 数 
String phoneNumber=""; 
if (numCount>0) {// 联 系 人 有 至 少 一 个 电话 号 码 
// 在 类 ContactsContract .CommonDataKinds. Phone 中 根据 id 查询 相应 联系 人 的 所 有 电 
话 ; 


Cursor phonecursor-getContentResolver().query ( 


ContactsContract.CommonDataKinds.Phone.CONTENT URI, 
null, 
ContactsContract .CommonDataKinds .Phone.CONTACT_ID+"=?", 
new String[]{Integer.toString (id) }, null) ; 
if (phonecursor.moveToFirst()) {// 仅 读 取 第 一 个 电话 号 码 
int numFieldIndex-phonecursor.getColumnIndex 
(ContactsContract .CommonDataKinds.Phone.NUMBER) ; 
phoneNumber-phonecursor.getString 
(numFieldIndex) ; 


} 
item=new HashMap<String, String>(); 
item.put ("name", name) ; 
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item.put ("phoneNumber", phoneNumber) ; 
data.add (item) ; 
} 
listAdapter=new SimpleAdapter (this,data, 
android.R.layout.simple_list_item_2, 
new String[]{"name", "phoneNumber"}, 
new 
int[] {android.R.id.text1,android.R.id.text2}) ; 
listview.setAdapter (listAdapter) ; 
} 
} 


其 中 : 


listAdapter=new SimpleAdapter (this, data, 
android.R.layout.simple_list_item_2, 
new String[]{"name", "phoneNumber"}, 
new 
int[] {android.R.id.text1,android.R.id.text2}) ; 
listview.setAdapter (listAdapter) ; 


使 用 了 Android 系统 提供 的 simple list item 2 布局 ， 并 将 该 布局 应 用 到 main.xml 文件 的 
ListView 组 件 中 。 


7.4.4 AA ContentProvider 


Android 系统 支持 任意 应 用 程序 创建 自己 的 ContentProvider， 以 便于 将 应 用 程序 的 数据 对 
其 他 应 用 程序 共享 。 
创建 应 用 程序 自己 的 ContentProvider， 需 要 以 下 几 个 步骤 : 


人 ED) 首先 ， 当 前 应 用 程序 必须 具有 自己 的 持久 化 数据 ， 例 如 文件 存储 或 者 使 用 SQLite 
数据 库存 储 。 

C€XX02 其 次 ， 当 前 应 用 程序 需要 实现 ContentProvider 的 子 类 ， 并 通过 该 子 类 完成 对 持久 化 
数据 的 访问 。 

€X303 RÉ, Æ AndroidManifest.xml 文件 中 使 用 <provider> 标 签 声明 当前 应 用 程序 定义 的 
ContentProvider。 此 外 ， 还 可 以 在 AndroidManifest.xml 文件 中 指定 相应 的 访问 权 
限 ， 以 保证 该 ContentProvider 仅 被 具有 相应 权限 的 应 用 程序 访问 。 若 不 指定 访问 权 
限 ， 则 任意 其 他 应 用 程序 都 可 以 访问 该 ContentProvider。 


在 实际 的 应 用 中 ， 为 了 方便 应 用 程序 所 定义 的 ContentProvider 被 其 他 应 用 程序 使 用 ， 通 
常会 定义 一 个 类 ， 将 ContentProvider 相关 信息 以 静态 常量 的 方式 放置 到 该 类 中 。 这 样 ， 使 用 
该 ContentProvider 的 应 用 程序 只 要 将 该 类 引用 进来 ， 就 可 以 获取 到 该 ContentProvider 的 相关 
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信息 ， 进 而 通过 其 对 数据 进行 操作 。 


本 节 以 7.3 节 中 使 用 的 实例 MyDbDemo 为 例 ， 为 该 实例 中 创建 的 SQLite 数据 库 mydb 中 
的 friends 数据 表 创 建 ContentProvider， 以 便于 其 他 应 用 程序 通过 该 ContentProvider 对 
friends 数据 表 中 的 数据 进行 访问 。 

在 实例 MyDbDemo 中 的 introduction.android.mydbDemo 包 下 创建 两 个 文件 ， 分 别 为 
MyDbProviderjava 和 MyFriendsDB.java。MyDbProvider 继承 了 ContentProvider 类 ， 实 现 了 针 
对 mydb 的 friends 数据 表 的 相关 操作 。MyFriendsDB 中 包含 了 涉及 MyDbProvider 的 相关 信 
息 。 

MyDbProvider.java 代码 如 下 : 


package introduction.android.mydbDemo; 
import android.content.ContentProvider; 
import android.content.ContentUris; 
import android.content.ContentValues; 
import android.content.UriMatcher; 
import android.database.Cursor; 
import android.database.sglite.SQLiteDatabase; 
import android.database.sqlite.SQLiteQueryBuilder; 
import android.net.Uri; 
import android.util.Log; 
public class MyDbProvider extends ContentProvider { 
private dbHelper mydbHelper; 
private static final UriMatcher myUriMatcher; 
static { 
myUriMatcher=new UriMatcher (UriMatcher.NO_MATCH) ; 
myUriMatcher.addURI (MyFriendsDB.AUTHORITY, "friends", 
MyFriendsDB.FRIENDS) ; 
myUriMatcher.addURI (MyFriendsDB.AUTHORITY, "friends/#", 
MyFriendsDB.FRIENDS ID) ; 
) 
GOverride 
public int delete (Uri uri, String selection, String[] 
selectionArgs) ( 
// TODO Auto-generated method stub 
if (myUriMatcher.match (uri) !=MyFriendsDB.FRIENDS_ID) { 
throw new IllegalArgumentException ("Wrong Insert Type: 
"suri) ; 
} 
String id=uri.getPathSegments().get (1) ; 
if (selection--null) 
selection=MyFriendsDB.ID+"="+id; 
else 
selection=MyFriendsDB.ID+"="+id+" and "+selection; 
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SQLiteDatabase db-mydbHelper.getWritableDatabase(); 
int i=db.delete (dbHelper.TB_NAME, selection, selectionArgs) ; 
if (i>0) 

Log.i ("myDbDemo",，" 数 据 更 新 成 功 ! ") ; 


else 
Log.i ("myDbDemo",，" 数 据 未 更 新 ! ") ; 
return i; 
} 
@Override 


public String getType (Uri uri) { 
// TODO Auto-generated method stub 
switch (myUriMatcher.match (uri) ) { 
case MyFriendsDB.FRIENDS: 
return MyFriendsDB.CONTENT_TYPE; 
case MyFriendsDB.FRIENDS_ID: 
return MyFriendsDB.CONTENT_ITEM_TYPE; 
default: 
throw new IllegalArgumentException ("Unknown URI get 
type: "turi) ; 
} 
} 
GOverride 
public Uri insert (Uri uri, ContentValues values) ( 
// TODO Auto-generated method stub 
if (myUriMatcher.match (uri) !-MyFriendsDB.FRIENDS) ( 
throw new IllegalArgumentException ("Wrong Insert Type: 
" ruri) 
} 
if (values--null) { 
throw new IllegalArgumentException ("Wrong Data.") ; 
} 
SQLiteDatabase db=mydbHelper.getWritableDatabase() ; 
long rowId-db.insert (MyFriendsDB.TABLE_NAME, null, values) ; 
if (rowId>0) { 
Uri insertUri-ContentUris.withAppendedId 
(MyFriendsDB.CONTENT URI, rowId) ; 
return insertUri; 
H 
return null; 
} 
@Override 
public boolean onCreate() { 
// TODO Auto-generated method stub 
mydbHelper=new dbHelper 
(getContext(),MyFriendsDB.DATABASE NAME,null,MyFriendsDB.DATABASE VERSION) 
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return false; 


} 


@Override 
public Cursor query (Uri uri, String[] projection, String selection, 


String[] selectionArgs, String sortOrder) { 
// TODO Auto-generated method stub 
switch (myUriMatcher.match (uri) ) { 
case MyFriendsDB.FRIENDS: 
break; 
case MyFriendsDB.FRIENDS_ID: 
Log.d ("MyDbProvider", "select id") ; 
String id=uri.getPathSegments().get (1) ; 
if (selection--null) 
selection=MyFriendsDB.ID+"="+id; 


else 
selection=MyFriendsDB.ID+"="+id+" and 
"+selection; 
break; 
default: 
throw new IllegalArgumentException ("Unknown URI type: 
"suri) ; 


} 
if (sortOrder==null) 


sortOrder="_id ASC"; 
SQLiteDatabase db-mydbHelper.getReadableDatabase(); 
Cursor c=db.query (MyFriendsDB.TABLE NAME, projection, 
selection, selectionArgs, null, 
null, sortOrder) ; 
Log.d ("MyDbProvider",""+c.getCount()) ; 


return c; 


) 


GOverride 
public int update (Uri uri, ContentValues values, String selection, 


String[] selectionArgs) ( 


// TODO Auto-generated method stub 
if (myUriMatcher.match (uri) !=MyFriendsDB.FRIENDS_ID) { 
throw new IllegalArgumentException ("Wrong Insert Type: 


"suri) ; 


) 
if (values--null) ( 
throw new IllegalArgumentException ("Wrong Data.") ; 


} 

String id=uri.getPathSegments().get (1) ; 

if (selection--null) 
selection=MyFriendsDB.ID+"="+id; 
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else 
selection=MyFriendsDB.ID+"="+id+" and "+selection; 
SQLiteDatabase db=mydbHelper.getWritableDatabase() ; 
int i=db.update (dbHelper.TB_NAME, values, selection, 
selectionArgs) ; 

if (i>0) 

Log.i ("myDbDemo"，," 数 据 更 新 成 功 ! ") ; 
else 

Log.i ("myDbDemo", "数据 未 更 新 ! ") ; 
return i; 


MyFriendsDB java 代码 如 下 : 


package introduction.android.mydbDemo; 
import android.net.Uri; 
public class MyFriendsDB { 
public static final String 
AUTHORITY-"introduction.android.mydbdemo.myfriendsdb"; 
public static final String DATABASE NAME-"mydb"; 
public static final int DATABASE VERSION-1; 
public static final String TABLE NAME-"friends"; 
public static final Uri CONTENT URI-Uri.parse 
("content: //"+AUTHORITY+"/friends") ; 
public static final int FRIENDS=1; 
public static final int FRIENDS_ID=2; 
public static final String 
CONTENT TYPE-"vnd.android.cursor.dir/mydb.friends.all"; 
public static final String 
CONTENT ITEM TYPE-"vnd.android.cursor.dir/mydb.friends.item"; public 
static final String ID-" id"; 
public static final String NAME-"name"; 
public static final String AGE-"age"; 


这 样 ， 就 定义 了 针对 mydb 的 friends 数据 表 的 ContentProvider， 最 后 需要 在 AndroidManifest. 
xml 文件 中 添加 该 ContentProvider 的 相应 声明 和 访问 权限 。AndroidManifest.xml 代码 如 下 : 


<?xml version="1.0" encoding="utf-8"?> 
«manifest xmlns:android="http: //schemas.android.com/apk/res/android" 
package="introduction.android.mydbDemo" 
android: versionCode="1" 
android: versionName="1.0"> 
<uses-sdk android:minSdkVersion="14" /> 
<uses-permission 
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android:name="introduction.android.permission.USE_MYDB"/> 
<application 
android: icon="@drawable/ic_launcher" 
android: label="@string/app_name"> 
<provider android:name="MyDbProvider" 


android: authorities="introduction.android.mydbdemo.myfriendsdb" /> 


<activity 
android: label="@string/app_name" 
android:name=".MyDbDemoActivity"> 
<intent-filter> 
<action android:name="android.intent.action.MAIN" /> 
<category 
android:name="android.intent.category.LAUNCHER" /> 
</intent-filter> 
</activity> 
</application> 


</manifest> 
该 文件 通过 如 下 代码 : 
<provider android:name="MyDbProvider" 


android: authorities="introduction.android.mydbdemo.myfriendsdb" /> 


指明 该 ContentProvider 名 为 MyDbProvider, i% ContentProvider 的 Authority "introduction. 
android.mydbdemo.myfriendsdb" . 

通过 如 下 代码 : 

<uses-permission 
android:name-"introduction.android.permission.USE MYDB"/» 


指明 该 ContentProvider [I] BUB Jg "introduction.android.permission USE MYDB", NARA 
了 该 权限 的 应 用 程序 才 可 以 访问 该 ContentProvider。 


7.4.5 AEX ContentProvider 


本 节 讲 解 如 何 通过 ContentProvider 访问 其 他 应 用 程序 中 的 数据 ， 并 对 数据 进行 更 改 。 实 
例 UseDbProvider 演示 了 通过 上 小 节 建 立 的 自 定 义 ContentProvider MyDbProvider 访问 实例 
MyDbDemo 中 建立 的 SQLite 数据 库 mydb， 并 对 其 中 的 数据 进行 CRUD 操作 的 过 程 。 实 例 
UseDbProvider 对 MyDbProvider 相关 信息 的 访问 是 从 MyFriendsDB 这 个 类 中 获取 到 的 。 

实例 UseDbProvider 运行 效果 如 图 7.6 所 示 。 该 视图 和 实例 MyDbDemo 一 样 ， 由 
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main.xml 和 list.xml 组 成 。 


n UseDbProvider 


图 7.6 UseDbProvider 界面 
该 实例 实现 步骤 如 下 : 


€XX01 在 Eclipse 中 建立 工程 UseDbProvider， 定 义 包 为 “introduction.android. useDbprovider" , 
定义 Activity 为 UseDbCPActivity。 
€o 从 工程 MyDbDemo 中 导出 MyDbProvider 的 信息 描述 类 MyFriendsDB。 具 体操 作 方 


法 如 下 : 

e 右键 单 击 工程 MyDbDemo， 在 弹出 菜单 中 选择 Export 选项 ， 如 图 7.7 所 
EE 

o 在 弹出 的 对 话 框 中 选择 导出 类 型 为 Java | JAR file, Xx Next 按钮 ， 如 图 
7.8 所 示 ; 


emove trom Context 


4 39 MyDbDemo 


4 (B src Build Path 
4 iB niota Source Select an export destination: 
H i Refactor type filter text 

yt 一 一 一 一 一 

n MyDbP| E mpor- C JAR file 

D Ni rā Export.. @) Javadoc 
GB gen enerenm Rafarancas a Runnable JAR file 
图 7.7 选择 Export 选 项 图 7.8 选择 导出 类 型 


o 在 弹出 的 对 话 框 中 选择 导出 资源 为 MyFriendsDB.Java， 导 出 的 目标 文件 为 
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“C:\IMyDbProviderjar”。 单 击 Finish 按钮 。 这样， 就 把 MyFriendsDB 类 导出 到 
myProviderjar 文件 中 ， 也 就 可 以 导出 到 其 他 文件 中 使 用 了 ， 如 图 7.9 所 示 。 


[rm 


JAR File Specification 
Define which resources should be exported into the JAR j 


Z Expor generated cas Res and resources 
Export all output folders for checked projects 
Export tava ourer Ses and resources 
Export refactorings for checked projects. Select relaci 


Select the export destination: 
| JAR flee CivoyObProviderjar = (rome. | 
Options: 

VV Compress the contents of the JAR fle 

Add directory emnes 

rewrite existing Ret without ware 


图 7.9 导出 过 程 


€ 在 工程 MyFriendsDB 中 导入 MyFriendsDB。 右 键 单 击 UseDbProvider， 选 择 Build 
Path | Add External Archives 选项 (如 图 7.10 Pra) ， 在 弹出 的 对 话 框 中 选中 


MyDbProvder.jar 即 可 将 MyFriendsDB 类 导入 到 工程 中 。 


Remove from Context Ctrl+Alt+Shift+Down 


Build Path SFE 


Source 
Refactor 


Alt+Shift+s » 
Alt+Shift+T » 
Import... 
Export. 
Bi Android 9 Refresh 5 


7.10 选择 Add External Archives 选项 


€ 
而 完成 对 数据 的 操作 。 


实例 UseDbProvider 中 的 UseDbCPActivityjava 代码 如 下 : 


package introduction.android.useDbprovider; 
import java.util.ArrayList; 

import java.util.HashMap; 

import java.util.List; 

import java.util.Map; 


New Source Folder... 


Use as Source Folder 
Add External Archives... 
Add Libraries... 


È Configure Build Path... 


编写 UseDbCPActivity 类 ， 通 过 ContentResolver 完成 对 MyDbProvider 的 访问 ， 进 
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import introduction.android.mydbDemo.MyFriendsDB; 
import android.app.Activity; 
import android.content.ContentUris; 
import android.content.ContentValues; 
import android.database.Cursor; 
import android.net.Uri; 
import android.os.Bundle; 
import android.util.Log; 
import android.view.View; 
import android.widget.AdapterView; 
import android.widget.Button; 
import android.widget.EditText; 
import android.widget.ListView; 
import android.widget.SimpleAdapter; 
import android.widget.AdapterView.OnItemClickListener; 
public class UseDbCPActivity extends Activity { 
private List<Map<String, String>>data; 
private SimpleAdapter listAdapter; 
private ListView listview; 
private HashMap<String, String>item; 
private Button selBtn,addBtn,updBtn,delBtn; 
private EditText et_name; 
private EditText et_age; 
private EditText et_id; 
/** Called when the activity is first created. */ 
GOverride 
public void onCreate (Bundle savedInstanceState) ( 
super.onCreate (savedInstanceState) ; 
setContentView (R.layout.main) ; 
et name- (EditText) findViewById (R.id.et name) ; 
et age- (EditText) findViewById (R.id.et age) ; 
et id- (EditText) findViewById (R.id.et id) ; 
listview- (ListView) findViewById (R.id.listView) ; 
selBtn- (Button) findViewById (R.id.bt query) ; 
addBtn- (Button) findViewById (R.id.bt add) ; 
updBtn- (Button) findViewById (R.id.bt modify) ; 
delBtn- (Button) findViewById (R.id.bt del) ; 
selBtn.setOnClickListener (new Button.OnClickListener()( 
@override 
public void onClick (View v) { 
// TODO Auto-generated method stub 
if (et id.getText().toString().equals ("") ) 
dbFindAll (MyFriendsDB.CONTENT TYPE) ; 
else 
dbFindAll (MyFriendsDB.CONTENT ITEM TYPE) ;; 
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addBtn.setOnClickListener (new Button.OnClickListener()( 
@override 
public void onClick (View v) { 
// TODO Auto-generated method stub 
dbAdd (null) ; 
GbFindAll (MyFriendsDB.CONTENT TYPE) ; 


YN; 
updBtn.setOnClickListener (new Button.OnClickListener () { 
@Override 
public void onClick (View v) { 
// TODO Auto-generated method stub 
dbUpdate (null) ; 
dbFindAll (MyFriendsDB.CONTENT TYPE) ; 


} 
3275 
delBtn.setOnClickListener (new Button.OnClickListener()( 
@Override 
public void onClick (View v) { 
// TODO Auto-generated method stub 
dbDel (-1) ; 
dbFindAll (MyFriendsDB.CONTENT_TYPE) ; 
} 
n: 


data=new ArrayList«Map«String,String»»(); 
dbFindAll (MyFriendsDB.CONTENT TYPE) ; 
listview.setOnItemClickListener (new OnItemClickListener () { 
private String selId; 
@Override 
public void onItemClick (AdapterView<?>parent, View v, 
int position, long id) { 
// TODO Auto-generated method stub 
Map<String, Object>listItem= (Map<String, Object>) 
listview.getItemAtPosition (position) ; 
et_name.setText ( (String) listItem.get 
("name") ) ; 
et age.setText ( (String) listItem.get ("age") ) ; 


et id.setText ( (String) listItem.get (" id") ) ; 
Log.i ("UseDB", "id="+selId) ; 


H): 
y 


private void showList(){ 
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// TODO Auto-generated method stub 
listAdapter-new SimpleAdapter (this, data, 
R.layout.listview, 
new String[]{"_id", "name", "age"}, 
new int[]{R.id.tvID,R.id.tvName,R.id.tvAge}) ; 
listview.setAdapter (listAdapter) ; 
} 
protected void dbDel (long iid) { 
// TODO Auto-generated method stub 
if (iid<0) { 
String id-et id.getText().toString().trim(); 
if (id.equals ("") ) ( 
Log.e ("UseDB"，" 未 指定 更 新 数据 。" ) ; 
return; 
} 
iid=Long.parseLong (id) ; 
} 
Uri uri-ContentUris.withAppendedId 
(MyFriendsDB.CONTENT URI,iid) ; 
int i-this.getContentResolver().delete (uri, null, null) ; 
if (i»0) ( 
Log.i ("UseDB", "已 删除 数据 id="+iid) ; 
Jelse( 


Log.i ("UseDB", "数据 未 删除 。"); 


} 
protected void dbUpdate (ContentValues values) { 
// TODO Auto-generated method stub 
String id-et id.getText().toString().trim(); 
if (id.equals ("") ) { 
Log.e ("UseDB", "未 指定 更 新 数据 。" ) ; 
return; 
} 
Long selid=Long.parseLong (id) ; 
Uri uri=ContentUris.withAppendedId 
(MyFriendsDB.CONTENT_URI,selid) ; 
if (values--null) { 
values-new ContentValues(); 
values.put ("name", 
et name.getText().toString().trim()) ; 
values.put ("age", et age.getText().toString().trim()) ; 
H 
int i-this.getContentResolver().update (uri, values, null, 
null) ; 
if (i>0) ( 
Log.i ("UseDB", "已 更 新 数据 id="+selid) ; 
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}else{ 
Log.e ("UseDB", "数据 更 新 失败 ! ") ; 


} 
protected void dbAdd (ContentValues values) { 
// TODO Auto-generated method stub 
if (values--null) { 
values-new ContentValues(); 
values.put ("name", 
et name.getText().toString().trim()) ; 
values.put ("age", et age.getText().toString().trim()) ; 
b 
Uri uri-this.getContentResolver().insert 
(MyFriendsDB.CONTENT URI, values) ; 
if (uri--null) ( 


Log.e ("UseDB" , "fri AW! ") ; 


) 
protected void dbFindAll (String type) ( 
// TODO Auto-generated method stub 
data.clear(); 
Cursor cursor; 
Url uri. 
if (type--MyFriendsDB.CONTENT TYPE) ( 
uri-MyFriendsDB.CONTENT URI; 
}else{ 
Long selid=Long.parseLong 
(et id.getText().toString().trim()) ; 
uri-ContentUris.withAppendedId 
(MyFriendsDB.CONTENT URI,selid) ; 
Log.d ("UseDB",uri.toString()) ; 
} 
cursor=this.getContentResolver().query (uri, null, null, null, 
mule 
cursor.moveToFirst(); 
while (!cursor.isAfterLast()) ( 
String id-cursor.getString (0) ; 
String name-cursor.getString (1) ; 
String age-cursor.getString (2) ; 
item-new HashMap«String,String»(); 
item.put (" id", id); 
item.put ("name", name) ; 
item.put ("age", age) ; 
data.add (item) ; 
cursor.moveToNext () ; 
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showList (); 


} 


由 于 工程 MyDbDemo 中 定义 了 MyDbProvider 的 访问 权限 ， 因 此 实例 UseDbProvider 的 
AndroidManifest.xml 文件 中 也 必须 声明 相应 权限 。AndroidManifestxml 文件 代码 如 下 : 


<?xml version="1.0" encoding-"utf-8"?» 

«manifest xmlns:android-"http://schemas.android.com/apk/res/android" 
package="introduction.android.useDbprovider" 
android: versionCode="1" 
android: versionName="1.0"> 

<uses-sdk android:minSdkVersion="14" /> 
<uses-permission 
android:name-"introduction.android.permission.USE MYDB"/» 
«application 
android:icon-"Gdrawable/ic launcher" 
android:label-"Gstring/app name"» 
«activity 
android: label="@string/app_name" 
android:name=".UseDbCPActivity"> 
<intent-filter> 
«action android:name-"android.intent.action.MAIN" /> 
«category 
android:name-"android.intent.category.LAUNCHER" /» 
«/intent-filter» 
«/activity» 
«/application» 
«/manifest» 


在 实例 UseDbProvider 中 对 SQLite 数据 库 mydb 进行 CRUD 操作 后 ， 运 行 MyDbDemo 进 
行 查询 ， 可 发 现 数据 库 中 的 数据 确实 被 改变 了 。 由 此 实现 了 在 一 个 应 用 程序 中 通过 自 定义 的 
ContentProvider 修改 另外 一 个 应 用 程序 中 的 持久 化 数据 的 功能 。 


.JJ 数据 同步 到 云端 


7.5.1 App Engine 简介 


通过 提供 强大 的 Internet 连接 API, Android 框架 可 以 帮助 开发 者 创建 云端 应 用 程序 ， 使 
用 户 将 数据 同步 到 远 端的 Web 服务 器 上 ， 确 保 用 户 设备 中 的 数据 总 是 与 服务 器 上 的 数据 同 
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步 ， 并且 用 户 的 重要 数据 总 是 在 云端 服务 器 上 拥有 备份 。 


本 小 节 将 讲解 如 何 将 用 户 数 据 同步 到 Google App Engine 的 过 程 。Google App Engine 是 
一 个 开发 、 托 管 网 络 应 用 程序 的 平台 ， 基 于 云 计算 技术 开发 ， 使 用 Google 管理 的 数据 中 心 。 

通过 使 用 Google App Engine， 开 发 者 可 以 在 Google 基础 架构 上 运行 网 络 应 用 程序 。App 
Engine 应 用 程序 易于 构建 和 维护 ， 并 且 可 随 着 通信 和 量 和 数据 存储 需求 增长 而 轻松 扩展 。 在 使 
用 Google App Engine 时 ， 不 需要 维护 任何 服务 器 : 只 需 上 传 应 用 程序 ， 它 便 可 以 为 用 户 提供 
服务 。 

开发 者 可 以 使 用 Google Apps 通过 自己 的 域名 (如 http://www.example.com/) 提供 应 用 程 
序 。 或 者 使 用 appspot.com 域 中 的 免费 名 称 提供 应 用 程序 。 开 发 者 可 以 与 世界 各 地 的 用 户 共 
享 应 用 程序 ， 也 可 以 设置 访问 权限 ， 仅 限 某 个 单位 的 成 员 能 够 访问 应 用 程序 。 

Google App Engine 支持 使 用 几 种 编程 语言 编写 的 应 用 程序 。 通 过 使 用 App Engine 的 Java 
RunTime 环境 ， 开 发 者 可 以 使 用 标准 Java 技术 构建 应 用 程序 ， 包 括 JVM, Java Servlet 和 
Java 编程 语言 或 任何 其 他 基于 JVM 的 解释 器 或 编译 器 的 语言 (如 JavaScript EÈ Ruby) 。App 
Engine 还 提供 一 个 专用 的 Python 运行 时 环境 ， 其 中 包括 快速 Python 解释 器 和 Python 标准 
库 。 建 立 的 Java 和 Python 运行 时 环境 旨 在 确保 快速 安全 地 运行 应 用 程序 ， 而 不 会 受到 系统 
上 其 他 应 用 程序 的 干扰 。 

在 初期 使 用 App Engine 时 ， 开 发 者 不 需要 支付 任何 费用 。App Engine 为 所 有 应 用 程序 提 
供 最 多 500 MB 的 存储 空间 以 及 所 需 的 CPU 和 带宽 ， 以 保证 应 用 程序 的 正常 运行 。App 
Engine 为 每 个 应 用 程序 免费 提供 每 月 约 500 万 页 的 浏览 量 。 在 为 应 用 程序 启用 计 费 时 ， 将 提 
高 应 用 程序 的 免费 限制 ， 开 发 者 只 需 为 超过 免费 级 别 的 资源 付费 。 这 样 就 大 幅度 地 减 小 了 应 
用 程序 的 开发 成 本 ， 并 为 应 用 程序 的 宣传 和 传播 搭建 了 平台 。 

可 惜 的 是 ，Google App Engine 在 中 国 大 陆地 区 被 禁止 访问 ， 目 前 大 陆 的 开发 者 不 能 通过 
App Engine 发 布 自己 的 应 用 程序 ， 在 一 定 程度 上 限制 了 国内 开源 软件 的 发 展 。 本 章节 只 能 讲 
述 将 数据 同步 到 App Engine 的 过 程 ， 实 际 的 操作 过 程 要 由 读者 自己 实践 。 


7.5.2 ”创建 可 相互 通信 的 Android 和 App Engine 应 用 程序 


编写 将 数据 同步 到 云端 的 应 用 程序 是 很 难 的 事情 ， 需 要 确保 很 多 的 细节 工作 正确 ， 例 如 
服务 器 端 授权 、 客 户 端 授权 、 共 享 的 数据 模型 和 API 等 。 幸 运 的 是 ， 开 发 者 不 需要 自己 来 完 
成 每 一 件 事 ， 借 助 于 GPE (Google Plugin for Eclipse) 可 以 大 大 简化 开发 的 过 程 。GPE 用 于 
管理 Android 设备 与 Google App Engine 间 对 话 的 管道 。 

1. 准备 环境 

安装 GPE 和 GWT SDK. J _https://developers.google.com/eclipse/docs/install-from- 
zip?hl-zh-CN 页 面 可 以 获得 安装 GPE 的 帮助 。 由 于 笔者 使 用 的 Eclipse 版 本 为 Indigo， 即 3.7 
版 本 ， 因 此 笔者 从 http://dl.google.com/eclipse/plugin/core/3.7/zips/gpe-e37-latest-updatesite.zip 
下 载 了 GPE 3.7 版 本 ， 该 版 本 中 包含 了 GWT SDK 2.4 版 本 。 安 装 GPE 的 方法 很 简单 ， 单 击 
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Eclipse 界面 的 Help | install new software | add | Archive 命令 ， 在 弹出 的 对 话 框 中 选择 下 载 的 
gpe-e37-latest-updatesite.zip 文件 ， 单 击 OK 按钮 ， 如 图 7.11 所 示 。 在 弹出 的 对 话 框 中 选择 要 
安装 的 组 件 ， 并 进行 安装 ， 如 图 7.12 所 示 。 


(8 Add Repository =s 
Name: GPE3.7.0 Local... 


Location: jar:file:/D:/ FÉ/Android tools/com.google.gdt.eclips 


© 


7.11 ”安装 GPE3.7 


Name 


100 Google App Engine Tools for Android (requires ADT) 

[v] 4 Google App Engine Tools for Android 3.0.1.v201206290132-rel-r37 
{00 Google Plugin for Eclipse (required) 

v] KP Google Plugin for Eclipse 3.7 3.0.1.v201206290132-rel-r37 
100 GWT Designer for GPE (recommended) 

000 SDKs 

[v] £p Google Web Toolkit SDK 2.4.0 2.4.0./201206290132-rel-r37 


742 安装 GPE 组 件 


安装 Java App Engine SDK. J https;//developers.google.com/appengine/downloads?hl-zh- 
CN#Google App Engine SDK_ for Java 页 面 下 载 Google App Engine SDK for Java， 笔 者 下 载 
的 是 1.7.0 版本。 解压 到 硬盘 后 ， 在 Eclipse | Windows | Preferences | Google | App Engine | add 
界面 添加 解压 目录 ，Eclipse 会 检测 到 App Engine SDK 并 完成 安装 。 

注册 一 个 Google 账号 ， 以 便于 C2DM 功能 访问 。C2DM (Android Cloud to Device 
Messaging ) 是 Android 云 到 设备 信息 传递 框架 ， 用 于 从 云端 发 送 少量 数据 到 Android 客户 端 
设备 。 要 获取 服务 器 上 不 定时 更 新 的 信息 一 般 来 说 有 两 种 方法 ， 第 一 种 是 客户 端 使 用 拉 
(Pull) 的 方式 ， 隔 一 段 时 间 就 去 服务 器 上 获取 信息 ， 看 是 否 有 更 新 的 信息 出 现 。 第 二 种 就 是 
服务 器 使 用 推送 (Push) 的 方式 ， 当 服务 器 端 有 新 信息 了 ， 则 把 最 新 的 信息 Push 到 客户 端 
上 。 相 比 之 下 ，Push 方法 更 好 一 些 ， 不 仅 可 以 节省 客户 端的 网 络 流量 ， 更 能 够 节省 电量 。 
Android 从 2.2 版 本 开始 增加 了 C2DM 框架， 用 于 将 服务 器 的 信息 Push 到 客户 端 。 

2. 创建 工程 

当 安 装 好 GPE Ja, Eclipse 会 出 现 App Engine Connected Android Project 工程 类 型 。 工 程 
创建 向 导 会 提示 输入 C2DM 账户 信息 ， 这 个 账户 就 是 在 上 面 注册 的 新 账户 。 

工程 创建 完成 后 ， 会 出 现 两 个 项 目 ， 一 个 是 Android 应 用 程序 ， 另 一 个 是 App Engine 应 
用 程序 。 工 程 向 导 在 这 两 个 项 目 中 创建 了 示例 代码 ， 人 允许 用 户 通过 AccountManager 来 验证 
Android 设备 与 App Engine 之 间 的 交互 。 
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右 击 Android 项 目 ， 选 择 Debug As | Local App Engine Connected Android Application。 这 


样 就 能 够 测试 C2DM 的 功能 ， 同 时 也 
户 的 程序 。 


3. 创建 数据 层 


启动 了 一 个 App Engine 的 本 地 实例 对 象 ， 里 面包 含 了 用 


上 一 步 创 建 了 能 够 在 Android 设备 与 App Engine 间 进 行 交 互 的 工程 ， 下 面 修改 相关 代码 


实现 自己 的 功能 。 


首先 创建 数据 层 ， 它 定义 Android 设备 与 App Engine 之 间 共 享 的 数据 。 打开 App Engine 


项 目的 文件 夹 ， 定 位 到 (yourApp) -AppEngine 


src | Cyourapp) | server。 创 建 一 个 新 的 类 ， 


该 类 包含 了 需要 存储 到 云端 的 数据 。 示 例 代码 如 下 : 


package com.cloudtasks.server; 


import javax.persistence.*; 


@Entity 
public class Task { 


private String emailAddress; 


private String name; 
private String userId; 
private String note; 


era 


@GeneratedValue (strategy=GenerationType.IDENTITY) 


private Long id; 


public Task(){ 
5 


public String getEmailAddress()( 
return this.emailAddress; 


} 
public Long getId(){ 
return this.id; 


} 


H 


代码 中 的 @Entity,@ Id  @GeneratedValue 都 是 来 自 Java FE A fL, API， 这 些 注 释 都 是 必须 
的 。@Entity 需要 被 注释 在 类 声明 的 上 面 ， 表明 这 个 类 是 被 定义 在 数据 层 的 一 个 实体 。 
(à Id 5@GeneratedValue 分 别 表明 了 实体 类 的 id 与 该 id 形成 的 规则 。 在 上 面 的 代码 中 ， 
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GenerationType. IDENTITY 表示 该 实体 的 id 是 从 数据 库 中 生成 的 。 


完成 了 实体 数据 类 的 创建 后 ， 需 要 创建 Android 与 App Engine 程序 之 间 交 互 的 方法 。 这 


种 交互 的 方法 是 通过 创建 一 个 Remote Procedure Call (RPC) 服务 完成 的 。 具 体 实现 的 过 程 相 
对 复杂 ;但 是 GPE 提供 了 简单 的 实现 方式 。 在 App Engine 项 目的 源码 文件 夹 下 右 击 ， 选 择 
New | Other， 再 选择 Google | RPC Service， 会 出 现 向 导 ， 罗 列 出 所 有 已 创建 的 实体 类 ， 单 击 
Finish， 向 导 会 创建 一 个 Service 类 ， 它 包含 对 所 有 实体 类 的 创建 、 查 询 、 更 新 和 删除 
(CRUD) 操作 。 


4. 创建 持久 层 
持久 层 是 用 于 长 期 存放 应 用 程序 数据 的 地 方 。 根 据 要 存储 的 数据 类 型 ， 开 发 者 有 几 种 可 


选择 的 实现 方法 ， 其 中 由 Google 管理 的 可 实现 持久 层 的 方法 为 Google Storage for Developers 
和 App Engine 的 内 建 DataStore。 下 面 是 一 个 使 用 DataStore 实现 持久 层 的 示例 代码 。 


据 ， 


在 com.cloudtasks.server 包 下 创建 一 个 类 用 来 处 理 持久 层 的 输入 与 输出 . 为 了 访问 这 些 数 
需要 使 用 PersistenceManager 类 。 可 以 使 用 在 com.google.android.c2dm.server.PMF 包 下 的 


PMF 类 生成 这 个 类 的 一 个 实例 ， 然 后 使 用 该 实例 来 执行 基本 的 CRUD 操作 : 


Jie 
* Remove this object from the data store. 
cu 
public void delete (Long id) ( 
PersistenceManager pm-PMF.get().getPersistenceManager(); 
try ( 
Task item-pm.getObjectById (Task.class, id) ; 
pm.deletePersistent (item) ; 
) finally ( 
pm.close(); 
) 
} 


此 外 ， 也 可 以 使 用 Query 对 象 从 Datastore 来 检索 数据 。 


public Task find (Long id) { 
if (id--null) { 
return null; 
} 


PersistenceManager pm=PMF.get() .getPersistenceManager () ; 
try { 
Query query-pm.newQuery ("select from "+Task.class.getName() 
+" where id=="+id.toString()+" && emailAddress=='"+getUserEmail ( 


penny; 
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} catch (RuntimeException e) { 
System.out.println (e) ; 
throw e; 
) finally ( 
pm.close(); 
} 
D 


5. 从 Android 应 用 程序 进行 查询 和 更 新 

为 保证 Android 设备 与 App Engine 的 同步 ，Android 端 应 用 程序 需要 完成 两 件 事 情 : 从 
云端 拉 取 数 据 和 向 云端 发 送 数据 。 这 些 功 能 已 经 由 示例 代码 生成 了 ， 开 发 者 需要 进行 修改 以 
完成 自己 的 功能 。 

首先 ， 需 要 将 示例 代码 中 的 Activityjava 中 的 setHelloWorldScreenContent() 方 法 删除 ， 用 
实际 的 功能 代码 蔡 换 ， 然后， 交互 操作 应 该 在 AsyncTask 类 中 完成 ， 以 避免 网 络 操作 导致 UI 
线程 卡 住 ， 最 后 ， 访 问 云端 数据 ， 使 用 RequestFactory 来 进行 操作 ， 该 类 由 Eclipse plugin 提 
供 。 

如 果 云 端 数据 模型 包含 一 个 叫做 Task 的 对 象 ， 那 么 这 个 对 象 会 在 你 生成 RPC layer 的 时 
候 自动 创建 一 个 TaskRequest 类 对 象 ， 以 及 一 个 代表 单独 的 Task 的 TaskProxy 对 象 。 下 面 的 
代码 演示 了 向 服务 器 请 求 所 有 task 的 列表 的 功能 。 


public void fetchTasks (Long id) { 
// Request is wrapped in an AsyncTask to avoid making a network 
request 
// on the UI thread. 
new AsyncTask() { 
@Override 
protected List doInBackground (Long... arguments) { 
final List list=new ArrayList (); 
MyRequestFactory factory=Util.getRequestFactory (mContext, 
MyRequestFactory.class) ; 
TaskRequest taskRequest=factory.taskNinjaRequest () ; 


if (arguments. length==0 ll arguments[0]==-1) { 
factory.taskRequest().queryTasks().fire (new 
Receiver«list»()( 
@Override 
public void onSuccess (List arg0) { 
list.addAll (arg0) ; 
} 
31975 
) else ( 
newTask-true; 
factory.taskRequest().readTask (arguments[0]) .fire (new 
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Receiver (){ 
@Override 
public void onSuccess (TaskProxy arg0) { 
list.add (arg0) ; 
} 
De 
} 
return list; 
} 


@Override 
protected void onPostExecute (List result) { 
TaskNinjaActivity.this.dump (result) ; 


i 


}.execute (id) ; 


public void dump (List tasks) { 
for (TaskProxy task : tasks) { 
Log.i ("Task output", task.getName()+"\n"+task.getNote()) ; 


} 


AsyncTask 类 返回 了 一 个 TaskProxy 对 象 的 列表 ， 并 且 将 该 列表 作为 参数 发 送 给 了 dump 
Jrik. 

为 了 创建 一 个 新 的 任务 并 发 送 到 云端 ， 需 要 创建 一 个 新 的 请 求 对 象 并 使 用 它 来 创建 一 个 
proxy 对 象 。 然 后 通过 proxy 对 象 执行 它 的 更 新 方法 。 这 个 过 程 应 该 在 AsyncTask 中 被 执行 ， 
以 避免 阻塞 UI 线 程 。 相 关 代码 如 下 : 


new AsyncTask () { 
@Override 
protected Void doInBackground (Void... arg0) { 
MyRequestFactory factory- (MyRequestFactory) 
Util.getRequestFactory (TasksActivity.this, 
MyRequestFactory.class) ; 
TaskRequest request-factory.taskRequest(); 


// Create your local proxy object, populate it 
TaskProxy task-request.create (TaskProxy.class) ; 
task.setName (taskName) ; 

task.setNote (taskDetails) ; 

task.setDueDate (dueDate) ; 


// To the cloud! 
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request .updateTask (task) .fire(); 
return null; 
$ 


}.execute(); 


6. 配置 C2DM 服务 器 端 


为 了 配置 C2DM 的 消息 以 便 能 被 发 送 到 Android 设备 ， 我 们 回 到 App Engine 的 代码 处 并 
打开 生成 RPC 层 时 创建 的 Service 类 。 如 果 项 目 名 是 Foo, WiZ Service 类 的 名 字 就 叫 
FooService。 为 Service 每 一 个 方法 都 添加 代码 ， 允 许 执行 增加 、 删 除 和 更 新 数据 的 操作 ， 这 
FÉ C2DM 消息 才能 被 发 送 到 用 户 的 设备 上 。 对 数据 进行 更 新 的 相关 示例 代码 如 下 : 


public static Task updateTask (Task task) { 
task.setEmailAddress (DataStore.getUserEmail()) ; 
task=db.update (task) ; 
DataStore.sendC2DMUpdate 
(TaskChange . UPDATE+TaskChange.SEPARATOR+task.getId()) ; 
return task; 
3 


// Helper method. Given a String, send it to the current user's device 
via C2DM. 


public static void sendC2DMUpdate (String message) ( 
UserService userService-UserServiceFactory.getUserService(); 
User user-userService.getCurrentUser(); 
ServletContext 


context-RequestFactoryServlet.getThreadLocalRequest().getSession().getServ 
letContext(); 


SendMessage.sendMessage (context, user.getEmail(), message) ; 
} 


下 面 的 示例 代码 中 创建 了 一 个 帮助 类 TaskChange。 该 类 中 创建 了 一 些 常 量 ， 能 够 使 得 
App Engine 与 Android 应 用 程序 之 间 的 交互 更 加 简单 。 帮 助 类 应 该 被 创建 在 共享 文件 夹 中 。 
public class TaskChange { 
public static String UPDATE="Update"; 
public static String DELETE="Delete"; 


public static String SEPARATOR=":"; 
5 


7. 配置 C2DM 客户 端 


为 了 定义 当 Android 应 用 程序 接收 到 C2DM 的 消息 时 的 行为 ， 我 们 打开 C2DMReceiver 
类 , 找到 onMessage() 方 法 并 根据 接收 到 的 消息 类 型 修改 这 个 方法 。 


//In your C2DMReceiver class 
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public void notifyListener (Intent intent) { 
if (listener !=null) { 
Bundle extras=intent.getExtras(); 
if (extras !-null) { 
String message- (String) extras.get ("message") ; 
String[] messages-message.split (Pattern.quote 
(TaskChange.SEPARATOR) ) ; 
listener.onTaskUpdated (messages[0], Long.parseLong 
(messages[1]) ) ; 


} 
} 
H 
//Elsewhere in your code, wherever it makes sense to perform local 
updates 


public void onTasksUpdated (String messageType, Long id) { 
if (messageType.equals (TaskChange.DELETE) ) { 
// Delete this task from your local data store 


} else { 
// Call that monstrous Asynctask defined earlier. 
fetchTasks (id) ; 


了 


至 此 ，C2DM 消息 触发 了 本 地 Android 设备 中 信息 的 更 新 ， 同 步 到 云端 操作 完成 。 


数据 备份 与 恢复 


7.6.1 Android 数据 备份 与 恢复 简介 


Android 的 备份 服务 允许 用 户 将 应 用 程序 的 持久 化 数据 复制 到 远 端 云 存储 ， 以 便 为 应 用 
程序 的 数据 和 设置 信息 创建 一 个 还 原点 。 如 果 用 户 为 设备 恢复 了 出 厂 设 置 或 者 更 换 了 新 的 
Android 设备 ， 当 安装 应 用 程序 时 系统 会 自动 恢复 用 户 备份 的 数据 到 应 用 程序 。 这 样 用 户 就 
不 需要 人 为 复制 之 前 的 数据 和 配置 信息 。 该 过 程 对 用 户 完全 透明 ， 不 会 影响 应 用 程序 的 功能 
和 用 户 体验 。 

当 应 用 程序 发 起 备份 请 求 ，Android 的 备份 管理 器 BackupManager 会 查询 需要 备份 的 应 
用 程序 数据 ， 并 将 其 交 给 备份 传输 器 ， 再 由 备份 传输 器 将 数据 传输 到 云 存储 保存 起 来 。 当 执 
行 恢复 操作 时 ， 备 份 管理 器 从 备份 传输 器 获取 备份 数据 并 交还 给 应 用 程序 ， 由 应 用 程序 将 备 
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份 数 据 恢复 到 设备 。 恢 复 操作 请 求 可 以 由 应 用 程序 发 起 ， 但 并 不 是 必须 的 。 如 果 应 用 程序 被 
安装 并 且 存 在 与 用 户 关 联 的 备份 数据 ， 当 用 户 重 置 了 手机 的 所 有 配置 或 者 升级 到 新 的 设备 
时 ，Android 系统 都 会 自动 执行 数据 恢复 操作 。 

需要 注意 的 是 ， 备 份 服务 并 不 是 为 了 与 其 他 设备 同步 数据 或 者 在 应 用 程序 的 正常 生命 周 
期 过 程 中 保存 数据 而 设计 。 备 份 的 数据 不 能 被 随意 访问 和 改写 ， 必 须要 使 用 备份 管理 器 提供 
的 API 进 行 访问 。 

备份 传输 器 是 Android 数据 备份 框架 的 客户 端 组 件 ， 由 设备 制造 商 和 服务 提供 商 共同 定 
制 。 备 份 传输 器 可 能 因 设备 的 不 同 而 不 同 ， 并 且 对 设备 而 言 是 透明 的 。 备 份 管理 器 将 应 用 程 
序 和 备份 传输 器 分 离开 来 ， 应 用 程序 通过 固定 的 API 与 备份 管理 器 进行 通信 ， 而 不 考虑 底层 
传输 的 具体 实现 过 程 。 

数据 备份 功能 并 不 保证 在 所 有 的 Android 设备 上 都 支持 。 但 是 ， 即 使 设备 不 支持 数据 备 
份 ， 应 用 程序 也 会 正常 运行 ， 只 是 不 能 接收 备份 管理 器 的 备份 请 求 对 数据 进行 备份 而 已 。 

备份 的 数据 不 会 被 设备 上 的 其 他 应 用 程序 访问 ， 只 有 备份 管理 器 和 备份 传输 器 有 权限 访 
问 备份 的 数据 。 另 外 ， 由 于 云 存储 数据 传输 服务 因 设备 的 不 同 而 不 同 ， 因 此 Android 系统 不 
能 保证 备份 数据 的 安全 性 。 所 以 当 用 户 使 用 云 存 储备 份 敏感 数据 时 《例如 用 户 名 和 密码 ) ， 
应 三 思 而 行 。 


7.6.2 ”实现 备份 代理 的 步骤 


为 了 备份 应 用 程序 数据 ， 需 要 使 用 备份 代理 。 备 份 代理 将 被 备份 管理 器 调用 ， 用 于 提供 
所 需 备份 的 数据 。 当 应 用 程序 被 重新 安装 时 ， 备 份 管理 器 还 要 调用 此 备份 代理 来 恢复 应 用 程 
序 的 数据 。 备 份 管理 器 通过 备份 传输 器 处 理 所 有 Android 设备 与 云 存储 之 间 的 数据 传输 工 
作 ， 而 备份 代理 则 负责 所 有 对 设备 上 数据 的 处 理 。 
实现 备份 代理 需要 经 过 以 下 步 又 : 
CXX0U 在 manifest 文 件 中 用 android:backupAgent 属性 声明 备份 代理 。 相 关 代码 如 下 : 
<manifest ...> 
aplicacion android:label-"MyApplication" 
android:backupAgent-"MyBackupAgent"^ 
«activity ...> 
es 


</application> 
</manifest> 


以 上 代码 为 应 用 程序 声明 了 一 个 名 为 MyBackupAgent 的 备份 代理 。 
€XX0 为 Android 备 份 服务 进行 注册 。 
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Google 为 Android 2.2 以 上 版 本 的 设备 提供 了 利用 Android 备份 服务 进行 备份 传输 的 服 
务 。 应 用 程序 要 利用 Android 备份 服务 执行 备份 操作 ， 必 须 对 应 用 程序 进行 注册 以 获得 一 个 
备份 服务 的 Backup Service Key， 然 后 在 Android manifest 文件 中 声明 这 个 Key。 

要 获取 Backup Service Key， 需 要 到 https://developers.google.com/android/backup/signup? 
hl-zh-CN 为 Android 服务 进行 注册 。 注 册 时 会 得 到 一 个 Backup Service Key 和 Android 
manifest 文件 内 相应 的 <meta-data>XML 代码 ， 这 段 代码 必须 包含 在 <application> 元 素 下 。 相 
关 示 例 代码 如 下 : 


«application android:label-"MyApplication" 
android:backupAgent-"MyBackupAgent"» 


«meta-data android:name-"com.google.android.backup.api key" 


android:value-"AEdPqrEAAAAIDaYEVgU6DUnyJdBmU7KLH3kszDXLv 4DISEIyQ" /> 
«/application» 


android:name ‘Us ji Ji: "com.google.android.backup.api key" , android:value 也 必须 是 注册 
Android 备份 服务 时 获得 的 Backup Service Key 
如 果 存 在 多 个 应 用 程序 ， 则 需要 根据 每 个 的 程序 的 package name 分 别 为 每 一 个 应 用 程序 
进行 注册 。 
aI 实现 备份 代理 。 
实现 备份 代理 有 两 种 方式 ， 分 别 为 : 
* 继承 BackupAgent。BackupAgent 类 提供 了 核心 接口 ， 应 用 程序 通过 这 些 接 口 与 备份 
管理 器 进行 通信 。 如 果 直 接 继承 此 类 ， 则 必须 履 盖 onBackup(0 和 onRestore() 方 法 来 处 
理 数据 的 备份 和 恢复 操作 。 
* 继承 BackupAgentHelper. BackupAgentHelper 类 提供 了 BackupAgent 类 的 易 用 性 封 
装 ， 大 幅度 减少 了 需 编写 的 代码 数量 。 在 BackupAgentHelper 内 ， 必 须 用 一 个 或 多 个 
helper 对 象 来 自动 备份 和 恢复 特定 类 型 的 数据 ， 因 此 不 再 需要 实现 onBackup() 和 
onRestore() 方 法 了 。 


Android 目前 提供 两 种 backup helper， 分 别 用 于 SharedPreferences 和 内 部 存储 的 备份 和 恢 
复 操作 。 


7.6.3 ”通过 BackupAgent 实现 备份 与 恢复 


大 多 数 应 用 程序 不 需要 直接 继承 BackupAgent 类 ， 而 是 继承 BackupAgentHelper 类 ,并 
利用 BackupAgentHelper 内 建 的 helper 类 自动 备份 和 恢复 文件 。 不 过 ， 以 下 三 种 情况 则 需要 
直接 继承 BackupAgent 类 来 实现 备份 代理 : 
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e 将 数据 格式 版 本 化 。 例 如 需要 在 恢复 数据 时 修正 格式 ， 可 以 建立 一 个 备份 代理 ， 在 数 
据 恢复 过 程 中 如 果 发 现 当前 版 本 和 备份 时 的 版 本 不 一 致 ， 可 以 执行 必要 的 兼容 性 修正 
工作 。 

不 是 备份 整个 文件 ， 而 是 指定 备份 部 分 数据 以 及 恢复 部 分 数据 到 设备 。 

o 备份 数据 库 中 的 数据 。 如果 应 用 程序 使 用 了 SQLite 数据 库 并 且 希 望 当 用 户 重 装 应 用 
程序 时 能 够 恢复 数据 库 中 的 数据 ， 则 需要 建立 一 个 自 定义 的 BackupAgent。 它 在 备份 
操作 时 从 数据 库 中 读 取 合适 的 数据 ， 在 恢复 数据 操作 时 建立 数据 表 并 插入 数据 。 


通过 继承 BackupAgent 类 创建 备份 代理 时 ， 必 须 实现 以 下 两 个 方法 : 


© onBackup()。 备 份 管理 器 在 程序 请 求 进行 备份 操作 后 将 调用 该 方法 。 在 该 方法 中 实现 
从 设备 读 取 应 用 程序 数据 ， 并 把 需 备 份 的 数据 传递 给 备份 管理 器 的 操作 。 

© onRestore()。 备 份 管理 器 在 恢复 数据 时 调用 该 方法 。 备 份 管理 器 调用 该 方法 时 将 传 入 
备份 的 数据 ， 并 通过 该 方法 将 数据 恢复 到 设备 上 。 


1. 备份 数据 


应 用 程序 发 出 数据 备份 请 求 时 ， 备 份 管理 器 将 调用 onBackup() 方 法 。 在 此 方法 内 必须 把 
要 备份 的 数据 提供 给 备份 管理 器 ， 然 后 将 数据 保存 到 云 存 储 中 。 

只 有 备份 管理 器 能 够 调用 备份 代理 中 的 onBackup0 方 法 。 当 数据 发 生 改变 并 需要 执行 备 
份 时 ， 需 要 调用 dataChanged0 方 法 发 起 备份 请 求 。 备 份 请 求 并 不 会 立即 导致 onBackup() 方 法 
的 调用 ， 备 份 服务 器 会 等 待 合适 的 时 机 ， 为 上 次 备份 操作 后 又 发 出 备份 请 求 的 所 有 应 用 程序 
执行 备份 操作 。 

onBackup() 方 法 需要 传 入 三 个 参数 ， 所 代表 意义 分 别 为 : 

© oldState: 表示 已 打开 的 、 只 读 的 文件 描述 符 ParcelFileDescriptor， 指 向 应 用 程序 提供 

的 上 次 备份 数据 状态 的 文件 。 该 文件 不 是 来 自 云 存 储 的 备份 数据 ， 而 是 记录 上 次 调用 
onBackup(O 备 份 数据 相关 状态 信息 的 本 地 文件 。onBackup() 方 法 不 能 读 取保 存 于 云 存 
储 的 数据 ， 可 以 根据 此 信息 来 判断 数据 自 上 次 备份 以 来 是 否 变动 过 。 

© Data: BackupDataOutput 对 象 ， 用 于 将 要 备份 的 数据 传 给 备份 管理 器 。 

* newState: 表示 已 打开 的 、 可 读 写 的 文件 描述 符 ParcelFileDescriptor， 指 向 一 个 用 于 将 
提交 给 data 参数 的 数据 相关 状态 信息 写 入 的 文件 ， 状 态 信息 可 以 简单 到 只 是 文件 的 最 
后 修改 时 间 。 备 份 管理 器 下 次 调用 onBackup0 时 ， 该 对 象 作为 oldState 传 入 。 如 果 没 
有 向 newState 写 入 信息 ， 则 备份 管理 器 下 次 调用 onBackup()it oldState 将 指向 一 个 空 
xd. 

利用 以 上 参数 ， 可 以 实现 onBackup0 方 法 如 下 : 


Eo 通过 比较 oldState， 检 查 自 上 次 备份 以 来 数据 是 否 发 生 过 改变 。 从 oldState 读 取信 
息 的 方式 取决 于 当时 写 入 的 方式 ( 见 第 3 步 ) 。 最 简单 的 记录 文件 状态 的 方式 是 写 
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入 文件 的 最 后 修改 时 间 戳 。 以 下 是 如 何 从 oldState 读 取 并 比较 时 间 改 的 代码 : 


// Get the oldState input stream 

FileInputStream instream=new FileInputStream 
(oldState.getFileDescriptor()) ; 

DataInputStream in=new DataInputStream (instream) ; 


try { 


file 


backup 


// Get the last modified timestamp from the state file and data 


long stateModified=in.readLong() ; 
long fileModified-mDataFile.lastModified(); 


if (stateModified !-fileModified) ( 
// The file has been modified, so do a backup 
// Or the time on the device changed, so be safe and do a 


} else ( 
// Don't back up because the file hasn't changed 
return; 

} 


} catch (IOException e) { 


} 


// Unable to read state file... be safe and do a backup 


如 果 数 据 没 有 发 生变 化 ， 就 不 需要 进行 备份 ， 请 跳 转 到 第 3 步 。 


cL 


必须 以 BackupDataOutput 中 的 “entity “方式 写 入 每 一 块 数据 。 
数据 记录 ， 使 用 一 个 唯一 的 字符 串 键 值 进行 标识 。 因 此 所 备份 的 数据 集 实 际 上 上 是 一 组 键 值 


在 和 oldState 比较 后 ， 如 果 数据 发 生 了 变化 ， 则 把 当前 数据 写 入 data 以 便 将 其 返回 


并 上 传 到 云 存 储 中 去 。 


对 。 要 在 备份 数据 集中 增加 一 个 entity， 必 须 : 


a) 调 月 
(2) ÑH 


字 节 数 ， 该 字 节 数 应 该 与 传 给 writeEntityHeader0 的 数据 大 小 一 致 。 
下 列 示例 代码 演示 了 把 一 些 数据 拼接 为 字 节 流 并 写 入 一 个 entity 的 过 程 : 


// Create buffer stream and data output stream for our data 


ByteArrayOutputStream bufStream=new ByteArrayOutputStream(); 
DataOutputStream outWriter-new DataOutputStream (bufStream) ; 

// Write structured data 

outWriter.writeUTF (mPlayerName) ; 

outWriter.writeInt (mPlayerScore) ; 

// Send the data to the Backup Manager via the BackupDataOutput 
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byte[] buffer-bufStream.toByteArray(); 

int len=buffer.length; 

data.writeEntityHeader (TOPSCORE_BACKUP_KEY, len) ; 
data.writeEntityData (buffer, len) ; 


需要 备份 的 每 一 块 数据 都 要 执行 一 次 该 操作 。 如 何 将 数据 切 分 为 entity 由 开发 者 决定 。 


ED 无 论 是 否 执行 了 数据 备份 (第 2 步 ) ， 都 要 把 当前 数据 的 状态 信息 写 入 newState 
ParcelFileDescriptor 指向 的 文件 内 。 备 份 管理 器 会 在 本 地 保持 此 对 象 ， 以 代表 当前 
备份 数据 。 下 次 调用 onBackup0 〇 时 ， 此 对 象 作为 oldState 返回 给 应 用 程序 ， 由 此 可 
以 决定 是 否 需要 再 做 一 次 备份 (如 第 1 HMB) 。 如 果 不 把 当前 数据 的 状态 写 入 此 
文件 ， 下 次 调用 时 oldState 将 返回 空 值 。 


以 下 示例 代码 把 文件 的 最 后 修改 时 间 戳 作为 当前 数据 的 状态 存 入 newState: 


FileOutputStream outstream=new FileOutputStream 
(newState.getFileDescriptor()) ; 

DataOutputStream out=new DataOutputStream (outstream) ; 

long modified-mDataFile.lastModified(); 

out.writeLong (modified) ; 


需要 注意 的 是 ， 如 果 应 用 程序 数据 存放 于 文件 中 ， 需 要 使 用 同步 语句 synchronized) 来 
访问 文件 。 这 样 在 应 用 程序 的 Activity 进行 写 文件 操作 时 ， 备 份 代 理 就 不 会 去 读 文 件 了 。 


2. 执行 数据 恢复 操作 

恢复 程序 数据 时 ， 备 份 管理 器 将 调用 备份 代理 的 onRestore0 方 法 。 调 用 此 方法 时 ， 备 份 
管理 器 会 把 在 云 储存 备份 的 数据 传 入 ， 以 供 恢复 到 设备 中 去 。 

只 有 备份 服务 器 能 够 调用 onRestore() 方 法 ， 在 系统 安装 应 用 程序 并 且 发 现 有 备份 数据 存 
在 时 ， 数 据 恢 复 操作 会 自动 发 生 。 此 外 应 用 程序 也 可 以 通过 调用 requestRestore0 方 法 来 发 起 
恢复 数据 的 请 求 。 

当 备份 管理 器 调用 onRestore() 方 法 时 ， 传 入 以 下 三 个 参数 : 

* Data: BackupDatalnput 对 象 ， 用 以 读 取 备 份 数据 。 

© appVersionCode: 整 型 数据 ， 表 示 备 份 数据 时 应 用 程序 的 manifest 的 android: 

versionCode 属性 。 可 以 用 于 核对 当前 应 用 程序 版 本 并 确定 数据 格式 的 兼容 性 。 

© newState: 已 打开 的 ， 可 读 写 的 文件 描述 符 ParcelFileDescriptor， 指 向 一 个 文件 ， 用 于 

写 入 最 后 一 次 提交 data 数据 的 备份 状态 。 本 对 象 在 下 次 调用 onBackup() 方 法 时 作为 
oldState 返回 。 


在 实现 onRestore0 时 ， 应 该 对 data 调用 readNextHeader0 ， 以 遍历 数据 集 里 所 有 的 
entity。 对 其 中 每 个 entity 须 进 行 以 下 操作 : 
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(1) 用 getKey0 方 法 获取 entity 的 键 值 。 

(2) 将 此 entity 键 值 和 已 知 键 值 清单 进行 比较 ， 这 个 清单 应 该 已 经 在 BackupAgent 继承 
类 中 作为 字符 串 常量 定义 。 一 旦 键 值 匹配 其 中 一 个 键 ， 就 执行 读 取 entity 数据 并 保存 到 设备 
的 操作 : 

* 用 getDataSize()is:JI& entity 数据 大 小 并 据 其 创建 字 节 数组 。 

© 调用 readEntityData0， 传 入 字 节 数组 作为 获取 数据 的 缓冲 区 ， 并 指定 起 始 位置 和 读 取 

PETS 

e 字 节 数组 将 被 填 入 数据 ， 按 需 读 取 数 据 并 写 入 设备 即 可 。 

(3) 把 数据 读 出 并 写 回 设备 以 后 ， 把 数据 的 状态 写 入 newState 参数 。 

下 列 实例 代码 将 前 面 小 节 例子 中 所 备份 的 数据 进行 了 恢复 : 

@Override 


public void onRestore (BackupDataInput data, int appVersionCode, 
ParcelFileDescriptor newState) throws IOException 


{ 
// There should be only one entity, but the safest 
// way to consume it is using a while loop 
while (data.readNextHeader()) { 
String key=data.getKey(); 
int dataSize-data.getDataSize(); 
// If the key is ours (for saving top score) . Note this key was 
used when 
// we wrote the backup entity header 
if (TOPSCORE_BACKUP_KEY.equals (key) ) ( 
// Create an input stream for the BackupDataInput 
byte[] dataBuf-new byte[dataSize] ; 
data.readEntityData (dataBuf, 0, dataSize) ; 
ByteArrayInputStream baStream=new ByteArrayInputStream 
(dataBuf) ; 
DataInputStream in=new DataInputStream (baStream) ; 
// Read the player name and score from the backup data 
mPlayerName-in.readUTF(); 
mPlayerScore-in.readInt(); 
// Record the score on the device (to a file or something) 
recordScore (mPlayerName, mPlayerScore) ; 
) else ( 
// We don't know this entity key. Skip it. (Shouldn't 
happen.) 


data.skipEntityData(); 
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i 


// Finally, write to the state blob (newState) that describes the 


restored data 
FileOutputStream outstream=new FileOutputStream 
(newState.getFileDescriptor()) ; 
DataOutputStream out=new DataOutputStream (outstream) ; 
out.writeUTF (mPlayerName) ; 
out.writeInt (mPlayerScore) ; 


) 


在 以 上 代码 中 ， 传 给 onRestore0) 的 appVersionCode 参数 没有 被 用 到 。 如 果 用 户 程序 的 版 
本 降低 ， 比 如 从 1.5 降 到 1.0， 则 可 能 就 会 用 此 参数 来 选择 备份 数据 。 


7.6.4 ”通过 BackupAgentHelper 实现 备份 与 恢复 


1. 实现 BackupAgentHelper 


如 果 要 备份 整个 SharedPreferences 和 内 部 存储 文件 ， 则 应 该 使 用 BackupAgentHelper 的 
子 类 创建 备份 代理 ， 这 种 方式 不 需要 实现 onBackup0 和 onRestore0) 方 法 ， 因 此 可 以 比 使 用 
BackupAgent 实现 的 方式 大 幅度 地 降低 代码 量 。 

BackupAgentHelper 的 实现 必须 要 使 用 一 个 或 多 个 backup helper。backup helper 是 一 种 专 
用 组 件 ，BackupAgentHelper 用 它 来 对 特定 类 型 的 数据 执行 备份 和 恢复 操作 。 

Android 框架 目前 提供 两 种 helper， 分 别 为 : 

* SharedPreferencesBackupHelper 用 于 备份 SharedPreferences 文件 。 

* FileBackupHelper 用 于 备份 内 部 存储 文件 。 


BackupAgentHelper 对 象 中 可 包含 多 个 helper， 但 对 于 每 种 数据 类 型 只 需 用 到 一 个 helper 
即 可 。 也 就 是 说 ， 即 使 存在 多 个 SharedPreferences 文件 ， 也 只 需要 一 个 SharedPreferences- 
BackupHelper 即 可 完成 对 文件 的 备份 与 恢复 。 

要 在 BackupAgentHelper 中 加 入 helper， 需 要 在 onCreate( 方 法 中 执行 以 下 步 又: 


ETO) 实例 化 所 需 的 helper， 并 在 其 构造 方法 中 指定 要 备份 的 文件 。 
C€XX02 调用 addHelper0 方 法 ， 把 helper 加 入 BackupAgentHelper。 


使 用 SharedPreferencesBackupHelper 备份 SharedPreferences 的 相关 代码 如 下 : 


public class MyPrefsBackupAgent extends BackupAgentHelper { 
// The name of the SharedPreferences file 
static final String PREFS="user_preferences"; 
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// A key to uniquely identify the set of backup data 
static final String PREFS_BACKUP_KEY="prefs"; 


// Allocate a helper and add it to the backup agent 
@Override 
public void onCreate() { 
SharedPreferencesBackupHelper helper=new 
SharedPreferencesBackupHelper (this, PREFS) ; 
addHelper (PREFS_BACKUP_KEY, helper) ; 


} 
5 


上 面 的 这 几 行 代码 实现 了 一 个 完整 的 备份 代理 MyPrefsBackupAgent. user preferences 是 
要 备份 的 文件 名 称 。SharedPreferencesBackupHelper 对 象 包 含 了 备份 和 恢复 SharedPreferences 
文件 的 所 有 代码 ， 不 再 需要 开发 者 人 为 书写 。 当 备份 管理 器 调用 onBackup0 方 法 和 
onRestore() 方 法 时 ，MyPrefsBackupAgent 会 调用 helper 来 完成 对 指定 文件 的 备份 和 恢复 操 
作 。 

由 于 SharedPreferences 是 线程 安全 的 ， 因 此 可 以 从 备份 代理 和 其 他 Activity 中 安全 地 读 
写 shared preferences 文件 。 


使 用 FileBackupHelper 备份 内 部 存储 文件 的 相关 代码 如 下 : 


public class MyFileBackupAgent extends BackupAgentHelper { 
// The name of the files 
static final String TOP_SCORES="scores"; 
static final String PLAYER STATS-"stats"; 


// A key to uniquely identify the set of backup data 
static final String FILES BACKUP KEY-"myfiles"; 


// Allocate a helper and add it to the backup agent 


void onCreate() { 
FileBackupHelper helper=new FileBackupHelper (this, TOP_SCORES, 


PLAYER_STATS) ; 
addHelper (FILES_BACKUP_KEY, helper) ; 


} 

B 

其 中 scores 和 stats 是 要 保存 的 文件 名 字 ， 上 面 的 代码 定义 的 helper 同时 对 两 个 文件 进行 
备份 和 恢复 操作 。 

需要 注意 的 是 ， 由 于 读 写 内 部 存储 文件 不 是 线程 安全 的 。 因 此 要 确保 当 Activity 在 进行 
文件 操作 时 备份 代理 不 会 去 读 写 该 文件 ， 因 此 每 次 读 写 文件 时 应 该 使 用 同步 语句 。 比 如 在 
Activity 读 写 文件 时 ， 需 要 用 一 个 对 象 作为 同步 语句 的 内 部 锁 。 事 实证 明 ， 长 度 为 零 的 数组 要 
比 普通 对 象 更 轻 量 化 ， 更 适合 作为 对 象 锁 使 用 。 
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创建 对 象 锁 代 码 如 下 : 
// 内 部 锁 对 象 


static final Object[] sDataLock=new Object[0]; 


然后 ， 每 次 读 写 文件 时 就 用 这 个 锁 对 象 创建 同步 语句 。 把 游戏 分 数 写 入 文件 的 同步 代码 
如 下 : 


try { 
synchronized (MyActivity.sDataLock) { 
File dataFile=new File (getFilesDir(), TOP_SCORES) ; 
RandomAccessFile raFile=new RandomAccessFile (dataFile, "rw") ; 
raFile.writeInt (score) ; 
} 
} catch (IOException e) { 
Log.e (TAG, "Unable to write to file") ; 


3 


当 读 文件 时 也 应 该 使 用 同一 个 锁 对 象 创建 同步 语句 。 
然后 ， 需 要 覆 六 BackupAgentHelper 的 onBackup0 和 onRestore0 方 法 ， 用 同一 个 内 部 锁 
同步 备份 和 恢复 操作 。 上 例 中 定义 的 MyFileBackupAgent 需要 添加 以 下 方法 : 


GOverride 
public void onBackup (ParcelFileDescriptor oldState, BackupDataOutput 


data, 
ParcelFileDescriptor newState) throws IOException { 
// Hold the lock while the FileBackupHelper performs backup 
synchronized (MyActivity.sDataLock) ( 
super.onBackup (oldState, data, newState) ; 


i; 


GOverride 
public void onRestore (BackupDataInput data, int appVersionCode, 
ParcelFileDescriptor newState) throws IOException { 
// Hold the lock while the FileBackupHelper restores the file 
synchronized (MyActivity.sDataLock) ( 
super.onRestore (data, appVersionCode, newState) ; 


} 
至 此 ， 完 成 了 使 用 FileBackupHelper 进行 文件 备份 和 恢复 操作 的 全 部 工作 。 


2. 核实 恢复 数据 的 版 本 
在 把 数据 备份 到 云 存储 中 的 过 程 中 ， 备 份 管理 器 会 自动 包含 应 用 程序 的 版 本 号 。 版 本 号 
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是 由 


manifest 文件 中 的 android:versionCode 属性 定义 的 。 在 调用 备份 代理 恢复 数据 之 前 ， 备 


份 管理 器 会 查询 已 安装 程序 的 android:versionCode 属性 ， 并 与 记录 在 备份 数据 中 的 版 本 号 相 
比较 。 如 果 备 份 数据 的 版 本 比 设备 上 的 要 高 ， 则 意味 着 用 户 安装 了 旧版 本 的 应 用 程序 。 这 时 
备份 管理 器 将 停止 数据 恢复 操作 ，onRestore() 方 法 也 不 会 被 调用 ， 因 为 把 数据 恢复 给 旧版 本 
的 应 用 程序 是 没有 意义 的 。 


通过 android:restoreAnyVersion 属性 可 以 替换 以 上 规则 。 此 属性 用 true 或 false 标明 是 否 


在 进行 数据 恢复 时 核实 数据 集 的 版 本 ， 默 认 值 是 false。 如 果 将 其 设 为 tue， 备 份 管理 器 将 忽 
Wt android:versionCode 属性 并 且 调 用 onRestore() 方 法 。 这 时 候 应 该 在 onRestore0 方 法 中 人 工 
核实 版 本 信息 ， 并 在 版 本 冲突 时 采取 必要 的 措施 保证 数据 的 兼容 性 。 


为 了 便于 在 恢复 数据 时 对 版 本 号 进行 判断 ，onRestore0 方 法 把 备份 数据 的 版 本 号 作为 


appVersionCode 参数 和 数据 一 起 传 入 方法 中 。 通 过 PackageInfo.versionCode 可 以 查询 到 当前 


应 用 


程序 的 版 本 号 ， 相 关 代 码 如 下 : 


PackageInfo info; 
try { 
String name=getPackageName () ; 
info=getPackageManager () .getPackageInfo (name,0) ; 
} catch (NameNotFoundException nnfe) { 
info-null; 
5 
int version; 
if (info !=null) ( 


version-info.versionCode; 
5 


然后 比较 一 下 传 入 onRestore() 方 法 的 appVersionCode 和 PackageInfo 的 version 值 即 可 。 
3. 请 求 数据 备份 
应 用 程序 在 任何 时 候 都 可 以 通过 调用 dataChanged() 方 法 来 发 起 备份 请 求 。 此 方法 将 通知 


备份 管理 器 用 备份 代理 来 备份 数据 。 备 份 管理 器 将 会 在 合适 的 时 候 调用 备份 代理 的 
onBackup0 方 法 。 通 常 每 次 数据 发 生变 化 时 都 应 该 请 求 备份 数据 ， 但 是 实际 的 备份 次 数 比 请 
求 次 数 少 得 多 。 如 果 在 备份 管理 器 执行 备份 操作 前 连续 请 求 了 很 多 次 ， 备 份 代理 仅 会 执行 一 
次 数据 备份 操作 。 


4. 请 求 数据 恢复 
在 应 用 程序 正常 的 生命 周期 内 ， 应 该 不 需要 发 起 恢复 数据 的 请 求 。 在 程序 安装 完成 时 ， 


系统 会 自动 检查 备份 数据 并 执行 数据 恢复 操作 。 在 必要 时 ， 也 可 以 通过 调用 requestRestore() 
方法 人 工 发 起 恢复 数据 的 请 求 。 这 时 ， 备 份 管理 器 会 调用 onRestore( 方 法 进行 数据 恢复 。 
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本 章 着 重 讲述 了 Android 系统 所 提供 的 信息 持久 化 方法 。 其 中 本 地 信息 存储 方式 有 三 
种 ， 分 别 为 SharedPreferences、 文 件 存储 和 数据 库存 储 。 进 行 数据 存储 时 要 根据 实际 情况 来 
选 定 合 适 的 数据 存储 方式 。 例 如 当 需 要 存储 简单 的 键 值 对 类 型 的 数据 时 使 用 SharedPreference 
比较 方便 ; 当 数 据 要 永久 存放 ， 当 便 以 多 种 途径 查看 时 应 使 用 文件 存储 ， 而 经 常 要 读 写 数据 
时 就 要 用 到 SQlite 等 等 。 

一 般 情况 下 ， 各 种 数据 都 被 其 应 用 程序 所 私有 。ContentProvider 提供 了 人 允许 在 不 同 应 用 
程序 之 间 共 享 私 有 持久 化 数据 的 接口 。 本 章 演示 了 如 何 对 现 有 的 SQLite 数据 库 建立 自 定义 
ContentProvider， 并 由 其 他 应 用 程序 通过 该 自 定 义 ContentProvider 访问 该 数据 库 中 的 数据 的 
过 程 。 

网 络 存储 主要 指 借助 于 Google 的 云 计算 平台 App Engine 进行 的 网 络 数据 同步 以 及 数据 
的 备份 与 恢复 。 借 助 于 信息 同步 技术 ， 可 以 使 用 户 方便 地 在 任何 地 方 获取 到 存储 在 云端 的 信 
息 的 最 新 版 本 。C2DM 技术 使 用 云端 push 方式 将 数据 从 云端 发 送 至 Android 客户 端 ， 大 幅度 
降低 了 Android 客户 端 与 云端 的 信息 流量 ， 节 省 了 耗 电 量 ， 并 且 降 低 了 编程 难度 。 云 端 数 据 
备份 与 恢复 技术 允许 用 户 将 重要 的 应 用 程序 信息 备份 到 云端 服务 器 上 ， 当 用 户 更 换 了 
Android 系统 的 手机 或 者 重 装 应 用 程序 时 ， 将 相关 的 信息 自动 恢复 到 用 户 设备 上 。 该 过 程 对 
用 户 完 全 透明 ， 极 大 地 方便 了 用 户 操作 使 用 ， 提 高 了 用 户 体验 。 


/.8 思考 是 


1. Android 数据 存储 方式 有 哪些 ? 各 有 什么 不 同 ? 

2. ContentProvider 是 如 何 实现 数据 共享 ? 

3. 如 何 才 能 使 用 外 部 存储 将 接收 到 的 短信 内 容 写 到 SD 卡 上 的 文件 中 。 

4. 编写 一 个 ContentProvider 小 应 用 ， 在 一 个 Demo 中 读 取 手 机 中 联系 人 的 姓名 并 把 姓名 
存储 到 SQLite 中 用 ListView 显示 出 来 。 
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网 络 编程 


从 本 章节 可 以 学 习 到 : 
* HTTP 通信 

* Socket 通信 

* Bluetooth 通信 

+ WIFI 通信 

* NFC 

* USB 

* SIP 
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Android 系统 提供 的 网 络 编程 方式 基于 Java 语言 ，Java 语言 提供 的 的 网 络 编程 方式 ， 在 
Andriod 中 都 提供 了 支持 。 具 体 的 编程 方式 包括 : 针对 TCP/IP 协议 的 Socket、ServerSocket 
编程 方式 ;针对 UDP 协议 的 DatagramSocket, DatagramPackage 编程 方式 ; 针对 直接 网 络 
URL 访问 的 URL, URLConnection 和 HttpURLConnection 方 式 等 。 本 章 将 对 常见 的 几 种 编程 
方式 进行 讲解 。 


8. ] HTTP 通信 


HTTP 英文 全 称 为 Hyper Text Transfer Protocol， 即 超 文 本 传输 协议 ， 一 种 详细 规定 了 浏 
览 器 和 万 维 网 (World Wide Web， 即 WWW) 服务 器 之 间 互 相通 信 的 规则 ， 通 过 因特网 传送 
万 维 网 文档 的 数据 传送 协议 。HTTP 协议 采用 了 请 求 /响应 CRequest/Response) 模式 ， 该 工 
作 模 式 单 向 、 同 步 。 在 客户 端 向 服务 器 发 送 请 求 之 后 ， 服 务 器 返回 结果 之 前 ， 客 户 端 只 能 等 
待 。 客 户 端 向 服务 器 发 送 一 个 请 求 ， 请 求 头 包含 了 请 求 的 方法 、URI、 协 议 版 本 ， 以 及 包含 
请 求 修饰 符 、 客 户 信息 和 内 容 的 类 似 于 MIME 的 消息 结构 。 服 务 器 以 一 个 状态 行 作为 响应 ， 
响应 的 内 容 包 括 消 息 协议 的 版 本 、 成 功 或 者 错误 编码 ， 还 包含 服务 器 信息 、 实 体 元 信息 以 及 
可 能 的 实体 内 容 。 它 是 一 个 属于 应 用 层 的 面向 对 象 的 协议 ， 由 于 其 简洁 、 快 速 ， 它 适用 于 分 
布 式 超 媒体 信息 系统 。 在 Internet 上 ，HTTP 通信 通常 发 生 在 TCP/IP 连接 之 上 ， 缺 省 端口 是 
80， 但 其 他 的 端口 也 是 可 用 的 。 

Android 是 一 种 以 Linux 为 基础 的 开放 源码 操作 系统 ， 在 其 内 部 包含 了 一 些 用 于 实现 
Android 网 络 数据 操作 的 接口 。Android 操作 系统 提供 3 种 网 络 接口 可 供 使 用 ， 它 们 分 别 是 : 
标准 Java 接口 、Apache 接口 和 Android 网 络 接口 。 其 中 Java 标准 接口 是 最 常用 的 ， 而 
Android 接口 是 Java 标准 接口 的 补充 。 

接 下 来 我 们 将 分 别 学 习 这 些 接口 ， 分 析 并 使 用 这 些 接口 实现 简单 的 网 络 操作 。 需 要 说 明 
的 是 ， 在 Android 系统 中 开发 Internet 应 用 程序 时 ， 需 要 在 AndroidManifestxml 文件 中 加 入 
如 下 权限 : 


«uses-permission android:name-"android.permission.INTERNET" /> 


1. 标准 Java 接口 


Android 提供 了 java.net.* 包 来 实现 访问 HTTP 服务 的 基本 功能 ， 其 中 包含 了 一 些 非 常 实 
用 的 与 网 络 操作 相关 的 接口 ， 包 括 流 和 数据 包 套 接 字 、Internet 协议 、 常 规 HTTP 处 理 等 。 

HTTP 协议 通过 URL 来 定位 资源 。URL (Uniform / Universal Resource Locator， 统 一 资 
源 定位 符 也 被 称 为 网 页 地 址 ) 是 因特网 上 标准 的 资源 的 地 址 Address) 。URL 是 用 于 完整 
地 描述 Intemet 上 网 页 和 其 他 资源 的 地 址 的 一 种 标识 方法 。 这 种 地 址 可 以 是 本 地 磁盘 ， 也 可 以 
是 局 域 网 上 的 某 一 台 计 算 机 ， 更 多 的 是 Internet 上 的 站 点 。 

URL 由 三 部 分 组 成 : 资源 类 型 、 存 放 资 源 的 主机 域名 、 资 源 文件 名 。 
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URL 的 一 般 语 法 格式 为 : 〈 带 方 括号 [] 的 为 可 选项 ) : 


protocol :// hostname[:port] / path / [;parameters] [?query] #fragment 


其 中 的 格式 说 明 为 : 

(1) protocol (协议 ) 

Protocol 指定 使 用 的 传输 协议 ， 表 8.1 列 出 了 常用 的 protocol 属性 的 有 效 方案 名 称 。 最 
常用 的 是 HTTP 协议 ， 它 也 是 目前 WWW 中 应 用 最 广 的 协议 。 


file 

ftp 
gopher 
http. 
https 


mailto 
MMS 
ed2k 


Flashget 


thunder 


news 


方案 名 称 | 描述 内 容 


表 8.1 protocol 属性 的 有 效 方案 


资源 是 本 地 计算 机 上 的 文件 ， 格 式 file:// 

通过 FTP 访 问 资源 ， 格 式 : FTP:// 

通过 Gopher 协议 访问 该 资源 

通过 HTTP 访 问 该 资源 ， 格 式 : HTTP:// 

通过 安全 的 HTTPS 访问 该 资源 ， 格 式 : target=_blank>HTTPS:// 

资源 为 电子 邮件 地 址 ， 通 过 SMTP 访问 ， 格 式 : mailto: 

通过 支持 MMS 〈 流 媒体 ) 协议 的 播放 该 资源 〈 代 表 软 件 : Windows Media Player) 格式 : 
MMS:// 

通过 支持 ed2k〈 专 用 下 载 链接 ) 协议 的 POP 软件 访问 该 资源 (代表 软件 ， 电 驴 ) 格式 ; ed2k:// 
通过 支持 Flashget: 〈 专 用 下 载 链接 ) 协议 的 P2P 软件 访问 该 资源 (代表 软件 : 快车 ) 格式 : 
Flashget:// 

通过 支持 thunder (专用 下 载 链接 ) 协议 的 P2P 软件 访问 该 资源 (代表 软件 ， 迅雷 格式: 
thunder:// 


通过 NNTP 访问 该 资源 


(2) hostname (主机 名 ) 

Hostname 是 指 存放 资源 的 服务 器 的 域名 系统 DNS) 、 主 机 名 或 IP 地 址 。 有 时 在 主机 
名 前 也 可 以 包含 连接 到 服务 器 所 需 的 用 户 名 和 密码 〈 格 式 : usemame(gpassword) 。 

(3) port Gig E145.) 

Port 为 整数 ， 是 可 选 的 ， 省 略 时 使 用 方案 的 默认 端口 ， 各 种 传输 协议 都 有 默认 的 端口 
号 ， 如 http 的 默认 端口 为 80。 如 果 输 入 时 省 略 ， 则 使 用 默认 端口 号 。 有 时 出 于 安全 或 其 他 
因素 考虑 ， 可 以 在 服务 器 上 对 端口 进行 重 定义 ， 即 采用 非 标准 端口 号 ， 此 时 ，URL 中 就 不 能 
省 略 端口 号 这 一 项 。 

(4) path (路 径 》 

Path 是 由 若干 “/” 符 号 隔 开 的 字符 串 ， 一 般 用 来 表示 主机 上 的 一 个 目录 或 文件 地 址 。 

(5) parameters (#2) 

Parameters 用 于 指定 特殊 参数 的 可 选项 。 
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(6) query (查询 ) 

Query 也 是 可 选项 ， 用 于 给 动态 网 页 (如 使 用 CGI、ISAPI、PHP/JSP/ASP/ASPNET 等 
技术 制作 的 网 页 ) 传递 参数 ， 可 有 多 个 参数 ， 用 “全 ”符号 隔 开 ， 每 个 参数 的 名 和 值 用 
“=” 符 号 隔 开 。 

(7) fragment (信息 片断 ) 

Fragment 是 字符 串 ， 用 于 指定 网 络 资源 中 的 片断 。 例 如 一 个 网 页 中 有 多 个 名 词 解释 ， 可 
使 用 fragment 直接 定位 到 某 一 名 词 解释 。 

使 用 Java 标准 接口 访问 网 络 资源 的 基本 步骤 如 下 : 


e 创建 URL. 

* 从 URL 创建 URLConnection /HttpURLConnection 对 象 并 设置 连接 参数 。 
e 连接 到 服务 器 。 

e 读 写 服务 器 数据 。 


Java.net.URL 类 用 于 封装 URL (Uniform Resource Locator) 地 址 ， 可 以 通过 该 类 与 特定 
URL 地 址 建立 连接 并 对 其 中 的 数据 进行 读 写 操作 。 若 封装 的 URL 地 址 格式 错误 ，URL 构造 
Jii iti MalformedURLException 异常 。 


2. Apache 接口 


Apache 实验 室 开源 的 包 org.apache.http.* 提 供 非常 丰富 的 网 络 操作 接口 。 弥 补 了 
java.net.* 灵 活性 不 足 的 缺点 ， 对 java.net.* 进 行 封装 ， 功 能 更 加 强大 和 全 面 ， 也 会 给 Android 
带 来 更 加 丰富 多 彩 的 网 络 应 用 。 在 Apache 网 络 接 口中 最 重要 的 是 HttpClient，HttpClient 是 
Apache Jakarta Common 下 的 子 项 目 ， 可 以 用 来 提供 高 效 的 、 最 新 的 、 功 能 丰富 的 支持 HITP 
协议 的 客户 端 编程 工具 包 ， 并 且 它 支持 HTTP 协议 最 新 的 版 本 和 建议 。HttpClient 已 经 应 用 
在 很 多 的 项 目 中 ， 比 如 Apache Jakarta. 上 很 著名 的 另外 两 个 开源 项 目 Cactus 和 HTMLUnit 都 
使 用 了 HttpClient。 它 是 一 个 开源 项 目 ， 功 能 更 加 完善 ， 为 客户 端的 HTTP 编程 提供 高 效 、 
最 新 、 功 能 丰富 的 工具 包 支 持 。Android 平台 引入 了 Apache HttpClient 的 同时 还 提供 了 对 它 
的 一 些 封装 和 扩展 ， 例 如 设置 缺 省 的 HTTP 超时 和 缓存 大 小 等 。Android 使 用 的 是 目前 最 新 
的 HttpClient4.0 Corg.apache.http.*) ， 可 以 将 Apache 视 为 目前 流行 的 开源 Web 服务 器 ， 主 
要 包括 创建 HttpClient 以 及 Get/Post, HttpRequest 等 对 象 ， 设 置 连接 参数 ， 执 行 HTTP f 
作 ， 处 理 服务 器 返回 结果 等 功能 。 

使 用 这 部 分 接口 的 基本 操作 与 java.net.* 基 本 类 似 ， 主 要 包括 : 

(1) 创建 HttpClient， 以 及 GetMethod / PostMethod 和 HttpRequest 等 对 象 。 

(2) 设置 连接 参数 。 

(3) 执行 HITP 操 作 。 

(4) 处 理 服务 器 返回 结果 。 

以 下 列 出 的 是 HttpClient 提供 的 主要 功能 。 

(D 实现 了 所 有 HTTP 的 方法 (GET, POST, PUT, HEAD 等 ) 。 
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(2) 支持 自动 转向 。 

(3) 支持 HITPS 协议 。 

(4) 支持 代理 服务 器 等 。 

使 用 HttpClient 时 也 需要 注意 请 求 报头 和 响应 报头 ， 以 及 提交 方式 ， 因 为 它 也 是 遵循 


HTTP 协议 。 下 面 简单 介绍 一 下 常用 的 GET 和 Post 方 式 在 代码 实现 上 有 什么 异同 。 


m 


在 GET 方式 下 使 用 HttpClient 需要 几 个 最 基本 步骤 : 
(1) 构造 HttpClient 的 实例 。 
(2) 创建 连接 方法 的 实例 ， 这 里 是 HttpGet， 在 HttpGet 的 构造 方法 里 面 传 入 待 连接 的 路 


(3) 请 求 HttpClient， 调 用 execute 传 入 HttPGet 取得 HttpResponse。 

(4) 读 HttpResponse， 在 读 之 前 判断 连接 状态 是 否 等 于 HttpStatus.SC_OK(200)。 

(5) 对 读 取 的 内 容 进 行 处 理 。 

Post 方式 相对 Get 有 些 差异 并 且 复杂 一 点 ， 主 要 是 参数 处 理 部 分 有 差异 。 在 Post 方式 下 


使 用 HttpClient 需要 几 个 最 基本 步骤 ; 


(1) 构造 HttpClient 的 实例 。 

(2) 向 HttpPost 的 构造 参数 中 传 和 路径， 创建 Post 连接 。 

(3) 准备 参数 ， 并 且 设 置 编码 等 相关 信息 。 

CD 将 准备 的 参数 设置 到 HttpPost 中 去 ， 方 法 是 HttpPost.setEntity(). 

(5) 得 到 HttpResponse， 通 过 httpClient.execute()f4 $l . 

(6) 读 取 HttpResponse。 

(7) 对 读 取 的 内 容 进 行 处 理 。 

需要 注意 的 是 在 网 络 操作 过 程 中 ， 需 要 Android 应 用 拥有 联网 权限 ， 可 以 在 


AndroidManifestxml 中 写 入 <uses-permission android:name="android.permission. INTERNET" 


</uses-permission> 权 限 。 


3. Android 网 络 接口 
android.net.* 包 实际 上 是 通过 对 Apache 中 HttpClient 的 封装 来 实现 的 一 个 HTTP 编程 接 


口 ， 同 时 还 提供 了 HTTP 请 求 队 列 管 理 以 及 HTTP 连接 池 管理 ， 以 提高 并 发 送 请 求情 况 下 的 
处 理 效率 ， 除 此 之 外 还 有 网 络 状态 监视 等 接口 、 网 络 访问 的 Socket、 常 用 的 Uri 类 以 及 有 关 
WiFi 相关 的 类 等 。 


8.1.1 访问 URL 指定 资源 


为 了 可 以 通过 AVD 调试 网 络 访问 应 用 程序 ， 首 先 在 本 地 计算 机 上 架设 网 络 服务 器 端 。 


使 用 Tomcat 做 服务 器 ， 在 其 webapps 目录 下 建立 android 目录 ， 并 在 该 目录 下 建立 
message.jsp 文件 。 
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<HTTP> 
<HEAD> 
<TITLE>HTTP-MESSAGE</TITLE> 
</HEAD> 
<BODY> 
<% 
out.println ("<H1>Http-Message<BR>Android:Hello World</H>") ; 
%> 
</BODY> 
</HTML> 


由 于 本 地 计算 机 在 网 络 上 的 IP 为 175.168.35.198， 因 此 messagejsp 的 网 络 URL 为 


http://175.168.35.198:8080/android/message.jsp。 将 该 地 址 输入 IE 地 址 栏 打 开 ， 其 运行 效果 如 
图 8.1 所 示 。 


[ @ HTTP-MESSAGE - Windows Internet Explorer eS) 
GO » [E hite:1/175.168.35.198:8080/android/messagejsp h >| S| 4|x |as- ”| 
cy MGE |Æ HTTP-MESSAGE A- A-5 wy RED 安全 (9) 
Http-Message 
Android:Hello World 
E @ Internet | 保护 模式 : BA fg v R100% v» 
L 


8.1 message.jsp 的 运行 效果 


这 样 ， 我 们 就 有 了 可 以 通过 AVD 来 访问 的 网 络 上 的 资源 。 

使 用 java.net.URLConnection 访问 URL 指定 的 网 络 资源 的 基本 过 程 代码 如 下 : 

URL url=new URL ("ftp://mirror.csclub.uwaterloo.ca/index.html") ;// 建 立 
URL 

URLConnection urlConnection=url.openConnection();// 打 开 连 接 

InputStream in=new BufferedInputStream 
(urlConnection.getInputStream()) ;// 从 连接 建立 输入 流 

try { 


readStream (in) ;// 读 取 数 据 操 作 
finally { 


in.close(); 
5 
5 


URLConnection 内 建 对 多 种 网 络 协议 的 支持 ， 如 HTTP/HTTPS, File. FTP. 
在 创建 连接 之 前 可 以 对 连接 的 一 些 属性 进行 设置 ， 如 表 8.2 所 示 。 
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# 8.2 URLConnection 属性 


属性 名 称 


属性 描述 
setReadTimeout (3000) 设置 读 取 数 据 的 超时 时 间 为 3 秒 钟 
setUseCaches (false) 设置 当前 连接 是 否 人 允许 使 用 缓存 


setDoOutput (true) 


setDoInput (true) 


HttpURLConnection 继承 于 URLConnection 类 ， 二 者 都 是 抽象 类 ， 所 以 无 法 直接 实例 
化 ， 其 对 象 主要 通过 URL 的 openConnection 方法 获得 。 


设置 当前 连接 是 否 允 许 建立 输出 流 
设置 当前 连接 是 否 允 许 建立 输入 流 


URLConnection 可 以 直接 转换 成 HttpURLConnection， 以 便于 使 用 一 些 HTTP 连接 特定 
的 方法 ， 如 getResponseMessage(), setRequestMethod(). 
使 用 HttpURLConnection 访 问 网 络 资源 的 基本 过 程 代码 如 下 : 


URL url=new URL ("http://www.android.com/") ; 

HttpURLConnection urlConnection= (HttpURLConnection) 
url.openConnection(); 

try { 


InputStream in-new BufferedInputStream 
(urlConnection.getInputStream()) ; 
readStream (in) ; 
finally ( 


urlConnection.disconnect(); 
} 
} 


需要 注意 的 是 使 用 openConnection 方法 所 创建 的 URLConnection 或 者 HttpURLConnection 
实例 不 具有 重用 性 ， 每 次 调用 openConnection 方法 都 将 创建 一 个 新 的 实例 。 


实例 URLDemo 中 演示 了 使 用 url 访问 指定 资源 的 过 程 ， 运 行 效 果 如 图 8.2 所 示 。 


图 8.2 URLDemo 的 运行 效果 
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实例 URLDemo 中 的 main.xml 的 代码 如 下 : 


<?xml version="1.0" encoding="utf-8"?> 
<LinearLayout 
xmlns :android="http: //schemas. android. com/apk/res/android" 
android: orientation="vertical" 
android: layout_width="fill parent" 
android: layout_height="fill parent"> 
<Button 
android: id="@+id/Button_HTTP" 
android: layout_width="fill parent" 
android: layout_height="wrap_ content" 
android: text="@string/button_name01"/> 
<TextView 
android: id="@+id/Text View HTTP" 
android: layout_width="fill parent" 
android:layout height-"wrap content" 
/? 
«/LinearLayout» 


实例 URLDemo 中 的 AndroidManifest.xml 的 代码 如 下 : 


<?xml version="1.0" encoding-"utf-8"?» 
«manifest xmlns:android="http://schemas.android.com/apk/res/android" 
package-"com.android.activity" 
android:versionCode-"1" 
android:versionName-"1.0"» 
«uses-sdk android:minSdkVersion-"4" /» 
«uses-permission android:name-"android.permission.INTERNET" /» 
«application android:icon-"Gdrawable/ic launcher" 
android: label="@string/app_name"> 
«activity android:name-".MainActivity" 
android: label="@string/app_name"> 
<intent-filter> 
<action android:name="android.intent.action.MAIN" /> 
<category 
android:name="android.intent.category.LAUNCHER" /> 
</intent-filter> 
</activity> 
</application> 
</manifest> 


实例 URLDemo 中 MainActivity.java 的 具体 实现 代码 如 下 : 
package introdction.android.URLDemo; 


import java.io.BufferedReader; 
import java.io.IOException; 
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import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 


java.net.URL; 


android.widget 
android.widget 


public 


java.io.InputStreamReader; 
java.net.HttpURLConnection; 
java.net.MalformedURLException; 


com.android.activity.R; 
android.app.Activity; 
android.os.Bundle; 
android.view.View; 
android.view.View.OnClickListener; 
.Button; 

.TextView; 


class MainActivity extends Activity ( 


/** Called when the activity is first created. */ 
private TextView textView HTTP; 


@Override 


public void onCreate (Bundle savedInstanceState) { 


super.onCreate (savedInstanceState) ; 

setContentView (R.layout.main) ; 

textView HTTP- (TextView) findViewById (R.id.TextView HTTP) ; 
Button button http- (Button) findViewById (R.id.Button HTTP) ; 


button http.setOnClickListener (new OnClickListener() {//#4 


button http 按钮 设置 监听 器 


public void onClick (View v) {// 事 件 处 理 


String 


httpUrl-"http://175.168.35.198:8080/android/message.jsp"; 


String resultData="";// 定义 一 个 resultData 用 于 存储 


获得 的 数据 
URL url-null;// 定义 URL 对 象 
try { 
url-new URL (httpUrl) ; // 构造 一 个 URL 对 象 时 
需要 使 用 异常 处 理 
} catch (MalformedURLException e) { 
System.out.println (e.getMessage()) ;// 打 印 
出 异常 信息 


} 
if (url !=null) {// 如 果 URL 不 为 空 时 
try {// 有 关 网 络 操作 时 ， 需 要 使 用 异常 处 理 


HttpURLConnection urlConn= 


(HttpURLConnection) url 


.openConnection();// 使 


用 HttpURLConnection 打开 连接 


InputStreamReader in=new 


InputStreamReader (urlConn 
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.getInputStream()) ;// 


em Rm 


BufferedReader buffer-new 
BufferedReader (in) ;// 为 输出 创建 BufferedReader 
String inputLine-null; 
while 
( € (àinputLine-buffer.readLine()) !-null) ) (// 读 取 获 得 的 数据 


得 到 读 取 的 内 容 


resultDatat+=inputLine+"\n";// 


加 上 "\n" 实 现 换行 
} 
in.close();// XH]InputStreamReader 
urlConn.disconnect();// X] HTTP 连接 
if (resultData !-null) {// 如 果 获 取 到 的 
数据 不 为 空 


textView_HTTP.setText 
(resultData) ;// 显 示 取 得 的 内 容 


} else { 
textView_HTTP.setText 
("Sorry,the content is null") ;// 获 取 到 的 数据 为 空 时 ， 显 示 


} 
} catch (IOException e) { 


textView_HTTP.setText 
(e.getMessage()) ;// 出 现 异 常 时 ， 打 印 出 异常 信息 
} 


} else { 
textView HTTP.setText ("url is null") ;//4 


url 为 空 时 输出 


0; 


代码 中 String httpUrl=" http://175.168.35.198:8080/android/message.jsp "指定 了 要 访问 的 
网 络 资源 的 地 址 ， 读 者 测试 时 改 成 自己 本 机 的 TP 地 址 即 可 。 


8.1.2 ”使 用 GET 方式 获取 网 络 服务 


HTTP 通信 中 使 用 Get 和 Post 方式 ，Get 方式 可 以 获取 静态 页 面 ， 也 可 以 把 参数 放 在 
URL 字符 后 面 ， 传 递 给 服务 器 ， 例 如 ， 地 址 “http://175.168.35.198:8080/android/getMessage. 
jsp?message-Helloworld" jf GET 方式 ,在 wl 中 “?” 后 面 直接 加 入 参数 message 的 信 
息 ， 而 POST 方式 的 参数 是 放 在 HTTP 请 求 中 ， 不 会 直接 出 现在 ul 中。 

与 Get 类似，Post 参 数 也 是 被 URL 编码 的 。 然 而 ， 两 者 已 经 有 了 很 多 不 同 : 

(D Get 是 从 服务 器 上 获取 数据 ，Post 是 向 服务 器 传送 数据 。 
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在 客户 端 ，Get 方式 通过 URL 提交 数据 ， 数 据 在 URL 中 可 以 看 到 ; Post 方式 是 通过 数 
据 放置 在 HTML HEADER 内 提交 。 
(2) 对 于 Get 方 式 ， 服 务 器 端 用 Request.QueryString 获取 变量 的 值 ， 对 于 Post 方 式 ， 服 
务 器 端 用 Request.Form 获取 提交 的 数据 。 
(3) Get 方 式 提交 的 数据 最 多 只 能 有 1024 字 节 ， 而 Post 则 没有 此 限制 。 
(4) 安全 性 问题 。 使 用 Get 的 时 候 ， 参 数 会 显示 在 地 址 栏 上 ， 而 Post 不 会 。 所 以 ， 如 果 
这 些 数 据 是 中 文 数据 而 且 是 非 敏感 数据 ， 那 么 使 用 Get 方式 ， 如 果 用 户 输入 的 数据 不 是 中 文 
字符 而 且 包含 敏感 数据 ， 那 么 还 是 使 用 Post 为 好 。 
HttpURLConnection 默认 的 访问 方式 为 GET, UA Post 方式 获取 网 页 数据 时 需要 使 用 
setRequestMethod 方 法 设置 访问 方式 为 POST。 
在 TOMCAT 根 目 录 下 的 “webappsvandroid” 目 录 下 建立 getMessage.jsp 文件 作为 网 络 服 
务 资源 文件 ， 该 文件 代码 如 下 : 
<%@ page language="java" import="java.util.*" pageEncoding="gb2312"%> 
<HTTP> 
<HEAD> 
<TITLE>Get-HTTP-MESSAGE</TITLE> 
</HEAD> 
<BODY> 
<% 
String message=request.getParameter ("message") ; 
String result=new String (message.getBytes ("iso-8859- 
(0 gb2312*)5- 
out.println ("<H1>Android-message:"+result+"</H>") ; 
$> 
</BODY> 
</HTML> 


该 文件 从 访问 该 文件 的 request 中 获取 名 为 message 的 参数 信息 并 在 页 面 上 显示 出 来 。 

Get 方式 获取 网 页 数据 的 实现 方式 和 指定 URL 方式 很 相似 ， 不 同 的 是 要 在 将 要 访问 的 地 
址 后 面 加 上 要 传递 的 参数 。 

实例 GETDemo 中 演示 了 使 用 GET 方式 访问 指定 网 页 的 过 程 ， 运 行 效果 如 图 8.3 所 示 。 


GET 方 式 获取 数据 


</HTML> 


图 8.3 实例 GETDemo 的 演示 过 程 
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实例 GETDemo 中 main.xml 的 具体 实现 代码 如 下 : 


<?xml version="1.0" encoding="utf-8"?> 
<LinearLayout 
xmins:android="http: //schemas. android. com/apk/res/android" 
android:orientation- "vertical" 
android:layout width-"fill parent" 
android:layout height-"fill parent"» 
«Button 
android: id="@+id/Button_Get" 
android: layout_width="fill_ parent" 
android: layout_height="wrap_ content" 
android: text="@string/button_name"/> 
<TextView 
android: id="@+id/Text View_Get" 
android: layout_width="fill parent" 
android:layout height-"wrap content" 
/? 
«/LinearLayout» 


实例 GETDemo 中 AndroidManifest.xml 的 具体 实现 代码 如 下 : 


<?xml version="1.0" encoding-"utf-8"?» 
«manifest xmlns:android-"http://schemas.android.com/apk/res/android" 
package- "com. android.activity" 
android:versionCode-"1" 
android:versionName-"1.0"» 
«uses-sdk android:minSdkVersion-"4" /» 
«uses-permission android:name-"android.permission.INTERNET" /» 
«application android:icon-"edrawable/ic launcher" 
android:label-"estring/app name"» 
«activity android:name-".MainActivity" 
android: label="@string/app_name"> 
<intent-filter> 
<action android:name="android.intent.action.MAIN" /> 
<category 
android:name="android. intent .category.LAUNCHER" /> 
</intent-filter> 
</activity> 
</application> 
</manifest> 


其 中 <uses-permission android:name="android.permission INTERNET" /> 设置 可 以 访问 网 络 
的 权限 。 
实例 GETDemo 中 MainActivityjava 的 具体 实现 代码 如 下 : 
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package introdction.android.getDemo; 
import java.io.BufferedReader; 
import java.io. IOException; 
import java.io. InputStreamReader; 
import java.net.HttpURLConnection; 
import java.net .MalformedURLException; 
import java.net.URL; 
import android.app.Activity; 
import android.os.Bundle; 
import android.view.View; 
import android.view.View.OnClickListener; 
import android.widget.Button; 
import android.widget.TextView; 
public class MainActivity extends Activity { 
private TextView textView_Get; 
@Override 
public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState) ; 
setContentView (R.layout.main) ; 
textView Get- (TextView) findViewById (R.id.TextView Get) ; 
Button button Get- (Button) findViewById (R.id.Button Get) ; 
button Get.setOnClickListener (new OnClickListener()( 
public void onClick (View v) ( 
String httpUrl-"http:// 
175.168.35.198:8080/android/getMessage.jsp?message-Helloworld"; 
String resultData-""; 
URL url-null; 
try ( 
url-new URL (httpUrl) ; 
} catch (MalformedURLException e) { 
System.out.println (e.getMessage()) ; 
j 
if (url !=null) { 
try { 
HttpURLConnection urlConn= 
(HttpURLConnection) url 
-openConnection(); 
InputStreamReader in-new 
InputStreamReader (urlConn 
.getInputStream()) ; 
BufferedReader buffer-new 
BufferedReader (in) ; 
String inputLine-null; 
while 
( € (inputLine=buffer.readLine()) !-null) ) { 
resultData+=inputLine+"\n"; 


294 


第 8 章 “网络 编程 
in.close(); 


urlConn.disconnect(); 
if (resultData !-null) { 
textView Get.setText 


(resultData) ; 


} else ( 
textView_Get.setText ("Sorry,the content is 


null") 


} catch (IOException e) ( 
textView Get.setText 
(e.getMessage()) ; 
} 
} else { 
textView_Get.setText ("url is null") ; 


Ni 


其 中 String httpUrl= “http://175.168.35.198:8080/android/getMessage.jsp?message=Helloworld " 
设置 了 要 访问 的 网 页 的 url， 其 中 “message=Helloworld” 设 置 要 传递 的 参数 message 的 值 为 
Helloworld。 


84.3 使 用 POST 方式 获取 网 络 服务 


实例 POSTDemo 中 演示 了 使 用 POST 方式 访问 getMessage.jsp 的 过 程 ， 运 行 效果 如 图 
8.4 所 示 。 


<TITL 
/HEAD> 


图 8.4 实例 POSTDemo 的 运行 效果 
实例 POSTDemo 中 main.xml 的 具体 实现 代码 如 下 : 


295 


droid 4.X 从 入 门 到 精通 


<?xml version="1.0" encoding="utf-8"?> 
<LinearLayout 
xmlns:android-"http://schemas.android.com/apk/res/android" 
android:orientation-"vertical" 
android:layout width-"fill parent" 
android:layout height-"fill parent"» 
«Button 
android: id="@+id/Button_Post" 
android: layout_width="fill parent" 
android: layout_height="wrap_ content" 
android: text="@string/button_name"/> 
<TextView 
android: id="@+id/Text View Post" 
android: layout_width="fill parent" 
android:layout height-"wrap content" 
/? 
</LinearLayout> 


实例 POSTDemo 中 AndroidManifest.xml 的 具体 实现 代码 如 下 : 


<?xml version="1.0" encoding="utf-8"?> 
«manifest xmlns:android-"http://schemas.android.com/apk/res/android" 
package-"com.android.activity" 
android:versionCode-"1" 
android:versionName-"1.0"» 
«uses-sdk android:minSdkVersion-"4" /» 
«uses-permission android:name-"android.permission.INTERNET" /» 
«application android:icon-"edrawable/ic launcher" 
android: label="@string/app_name"> 
«activity android:name-".MainActivity" 
android: label="@string/app_name"> 
<intent-filter> 
<action android:name="android.intent.action.MAIN" /> 
<category 
android:name="android. intent .category. LAUNCHER" /> 
</intent-filter> 
</activity> 
</application> 
</manifest> 


其 中 <uses-permission android:name-"android.permission INTERNET" /> 设置 可 以 访问 网 络 
的 权限 。 
实例 POSTDemo 中 MainActivityjava 的 具体 实现 代码 如 下 : 


package introdction.android.postDemo; 
import java.io.BufferedReader; 
import java.io.DataOutputStream; 
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java.io.IOException; 
java.io.InputStreamReader; 
java.net .HttpURLConnection; 
java.net .MalformedURLException; 
java.net.URL; 

java.net .URLEncoder; 
android.app.Activity; 
android.os.Bundle; 
android.view.View; 
android.view.View.OnClickListener; 
android.widget.Button; 
android.widget.TextView; 

class MainActivity extends Activity { 


private TextView textView_Post; 
@Override 
public void onCreate (Bundle savedInstanceState) { 


String 


(true) ; 
Type", "application/x-www-form-urlencoded") ; 


super.onCreate (savedInstanceState) ; 
setContentView (R.layout.main) ; 
textView Post- (TextView) findViewById (R.id.TextView_Post) ; 
Button button Post- (Button) findViewById (R.id.Button Post) ; 
button Post.setOnClickListener (new OnClickListener () { 
public void onClick (View v) { 
httpUrl-"http:// 175.168.35.198:8080/android/getMessage.jsp"; 
String resultData-""; 
URL url-null; 
try{ 
url-new URL (httpUrl) ; 
} 
catch (MalformedURLException e) { 
System.out.println (e.getMessage()) ; 
} 
if (url !-null) { 
try{ 
HttpURLConnection urlConn- 


(HttpURLConnection) url.openConnection() ; 


urlConn.setDoOutput (true) ; 
urlConn.setDoInput (true) ; 
urlConn.setRequestMethod ("POST") ; 


urlConn.setUseCaches (false) ; 
urlConn.setInstanceFollowRedirects 
urlConn.setRequestProperty ("Content- 


urlConn.connect(); 


DataOutputStream out-new DataOutputStream 


(urlConn.getOutputStream()) ; 
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String 
content="message="+URLEncoder.encode ("HelloWorld", "gb2312") ; 

out.writeBytes (content) ; 

out.flush(); 

out.close(); 

BufferedReader reader-new BufferedReader 
(new InputStreamReader (urlConn.getInputStream()) ) ; 

String inputLine-null; 


while 
€ € (inputLine=reader.readLine()) !-null) ) ( 


resultDatat+=inputLine+"\n"; 


} 
reader.close(); 


urlConn.disconnect(); 


if ( resultData !-null ) { 
textView Post.setText 
(resultData) ; 
H 
else ( 
textView Post.setText 
("Sorry,the content is null") ; 
H 


} 
catch (IOException e) { 


textView_Post.setText 
(e.getMessage()) ; 


} 
else{ 
textView_Post.setText ("url is null") ; 


2; 


其 中 String httpUrl-"http:// 175.168.35.198:8080/android/getMessage.jsp" i Ei. 22 Vj fal HY 
URL Ji, urlConn.setRequestMethod ("POST") 设置 访问 方式 为 POST 方式 。 


String content="message="+URLEncoder.encode ("HelloWorld", "gb2312") ; 
out.writeBytes (content) ; 


将 要 传递 的 message 的 值 传递 给 服务 器 。 此 外 ，Android 开发 包 还 提供 了 org.apache.http. 
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client.methods.HttpGet 和 org.apache.http.client.methods.HttpPost 两 个 类 分 别 用 于 处 理 GET 和 
POST 网 络 访问 方式 ， 此 处 不 再 描述 ， 读 者 可 参看 相关 文档 。 


8 。 2 Socket 通信 


Socket 编程 方式 是 比较 底层 的 网 络 编程 方式 ， 其 他 常见 的 高 级 网 络 通信 协议 (如 
HTTP) 基本 都 是 建立 在 Socket 编程 基础 之 上 的 ， 而 且 Socket 编程 是 跨 平台 的 编程 方式 ， 可 
以 再 异 构 语 言 之 间 进 行 通信 ， 所 以 Socket 通信 是 其 他 网 络 编程 方式 的 基础 ， 掌 握 Socket 网 
络 编程 方式 是 很 有 意义 的 。 


8.2.1 Socket 简介 


1. 什么 是 Socket 


Socket 的 英文 原 义 是 “ 孔 ” 或 “插座 ”。 作 为 4BDS UNIX 的 进程 通信 机 制 ， 取 后 一 种 
意思 。 通 常 也 称 作 “ 套 接 字 ”， 用 于 描述 IP 地 址 和 端口 ， 是 一 个 通信 链 的 句柄 。 在 Internet 
上 的 主机 一 般 运 行 了 多 个 服务 软件 ， 同 时 提供 几 种 服务 。 每 种 服务 都 打开 一 个 Socket, JA 
定 到 一 个 端口 上 ， 不 同 的 端口 对 应 于 不 同 的 服务 。 应 用 程序 通常 通过 “ 套 接 字 ”向 网 络 发 出 
请 求 或 者 应 答 网 络 请 求 。 它 是 支持 TCP/IP 协议 的 网 络 通信 的 基础 操作 单元 。 

Socket 进行 网 络 通信 必须 包含 5 个 组 成 信息 : 连接 使 用 的 协议 、 本 地 主机 的 IP 地 址 、 
本 地 进程 的 协议 端口 、 远 程 主机 的 TP 地 址 和 远程 进程 的 协议 端口 。 


2. Socket 通信 的 传输 模式 


Socket 有 两 种 传输 模式 ， 分 别 是 面向 连接 的 和 面向 无 链接 的 ， 应 用 程序 运行 时 使 用 哪 一 
种 模式 是 由 应 用 程序 本 身 需求 决定 的 。 

面向 连接 的 传输 模式 可 靠 性 比较 好 ， 它 使 用 TCP 协议 。TCP (Transmission Control 
Protocol) 协议 属于 传输 层 协议 ，TCP 提供 IP 环境 下 的 数据 可 靠 传 输 ， 它 提供 的 服务 包括 数 
据 流传 送 、 可 靠 性 、 有 效 流 控 、 全 双 工 操作 和 多 路 复 用 。 通 过 面向 连接 、 端 到 端 和 可 靠 的 数 
据 包 发 送 。 它 是 事先 为 所 发 送 的 数据 开辟 出 连接 好 的 通道 ， 然 后 再 进行 数据 发 送 。 在 这 种 传 
输 模 式 下 ， 发 送 方 和 接收 方 必须 首先 取得 Socket 连接 ， 并 且 一 旦 建立 了 连接 ，Socket 就 可 以 
使 用 一 个 流 接口 进行 读 写 数据 操作 了 ， 但 是 这 种 传输 模式 的 效率 低 。 

而 面向 无 链接 的 传输 模式 可 靠 性 不 好 ， 使 用 UDP (User Datagram Protocol) 协议 ， 与 
TCP 相 比 ，UDP 不 为 IP 提供 可 靠 性 、 流 控 或 差错 恢复 功能 。 一 般 来 说 ，TCP 对 应 的 是 可 靠 
性 要 求 高 的 应 用 ， 而 UDP 对 应 的 则 是 可 靠 性 要 求 低 、 传 输 经 济 的 应 用 。TCP 支持 的 应 用 协 
议 主要 有 : Telnet, FTP, SMTP 等 ; UDP 支持 的 应 用 层 协议 主要 有 : NFS 网络 文件 系 
统 ) SNMP (简单 网 络 管理 协议 ) 、DNS 〈 主 域名 称 系统 ) 、TFTP (通用 文件 传输 协议 ) 
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等 。 这 种 模式 的 操作 使 用 数据 报 协议 ， 一 个 数据 报 就 是 一 个 独立 的 单元 ， 它 包含 了 一 次 传输 
数据 的 所 有 信息 。 


8.2.2 Socket 使 用 方法 


在 Java 程序 设计 语言 中 包含 了 一 个 javanet* 包 ， 在 这 个 包 中 提供 了 Socket fil ServerSocket 
两 个 类 ， 它 们 分 别 用 于 表示 网 络 通信 中 双向 连接 的 客户 端 和 服务 器 端 ， 适 应 于 TCP 协议 。 
客户 端 Socket 的 构造 方法 如 表 8.3 所 示 。 


表 8.3 ”客户 端 Socket 的 构造 方法 


构造 方法 类 型 参数 解释 


address 参数 表示 要 连接 的 服务 器 端的 IP Hahk; port 为 连接 使 
用 的 端口 号 


address 参数 表示 连接 中 一 方 的 IP 地 址 ; port 参数 表示 的 是 连 
接 中 一 方 的 端口 号 ，stream 参数 用 来 标识 Socket 是 流 Socket 
还 是 数据 报 Socket 


host 参数 表示 连接 中 一 方 的 主机 名 ; port 参数 表示 的 是 连接 
中 一 方 的 端口 号 
host 参数 表示 连接 中 一 方 的 主机 名 ; port 参数 表示 的 是 连接 
Socket (String hostint port.boolean stream) 中 一 方 的 端口 号 ;stream 参数 用 来 标识 Socket 是 流 Socket 还 
是 数据 报 Socket 


Socket (SocketImpl impl) impl 参数 是 Socket 的 父 类 ， 用 来 创建 ServerSocket 和 Socket 


host 参数 表示 连接 中 一 方 的 主机 名 ; pot 参数 表示 的 是 连接 
中 一 方 的 端口 号 :localAddr 是 本 地 机 器 的 地 址 ，localPort 参 
数 表示 本 地 主机 的 端口 号 


Socket (InetAddress address,int port) 


Socket (InetAddress address,int portboolean 
stream) 


Socket (String host,int port) 


Socket (String hostint port.InetAddress 
localAddr.int localPort ) 


服务 器 端 ServerSocket 构造 方法 如 表 8.4 所 示 。 


表 8.4 服务 器 端 ServerSocket 构造 方法 
构造 方法 类 型 参数 解释 
ServerSocket (int port) port 参 数 表示 的 是 连接 中 一 方 的 端口 号 
ServerSocket (int port.int backlog) 


ServerSocket (int portint backlog.InetAddress | port 参数 表示 的 是 连接 中 一 方 的 端口 号 ; bindAddr 是 
bindAddr) ServerSocket 的 主机 地 址 


建立 TCP 连接 时 要 指定 端口 号 ， 而 0-1023 的 端口 号 为 系统 保留 的 ， 因 此 在 选择 端口 号 
的 时 候 ， 应 该 选择 一 个 大 于 1023 并 且 没 有 被 其 他 应 用 程序 占用 的 端口 号 。 
客户 端 Socket 对 象 的 建立 代码 如 下 : 


Socket socket; 
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BufferedReader in; 

PrintWriter out; 

try { 
socket=new Socket ("192.168.0.99",1234) ; 
in=new BufferedReader (new InputStreamReader 

(socket.getInputStream()) ) ; 

out=new PrintWriter (socket.getOutputStream(),true) ; 
// 进 行 输入 输出 操作 … 
in.close(); 
out.close(); 
Socket.close(); 

) catch (UnknownHostException e) ( 
// TODO Auto-generated catch block 
e.printStackTrace(); 

} catch (IOException e) { 
// TODO Auto-generated catch block 
e.printStackTrace(); 

} 


该 代码 创建 了 一 个 通过 1234 端口 、 连 接 IP HEY “192.168.0.99” [IRS HRI Socket 对 
象 ， 连 接 建立 后 通过 BufferedReader 和 PrintWriter 类 建立 输入 流 和 输出 流 ， 以 便 与 服务 器 传 
递 数据 。 当 连接 使 用 完毕 后 ， 先 关闭 输入 /输出 流 ， 再 关闭 Socket 连接 。 

服务 器 端的 ServerSocket 对 象 建立 后 需要 不 断 监 听 指 定 端口 ， 当 有 客户 端 请 求 时 调用 
accept() 方 法 接受 请 求 并 做 相应 的 处 理 。 需 要 注意 的 是 accept0 方 法 是 一 个 阻塞 函数 ， 该 方法 
被 调用 后 将 阻塞 进程 ， 等 待 客户 端 请 求 ， 直 到 有 客户 端 请 求 启动 并 请 求 连 接 到 该 端口 ， 然 后 
accept() 返 回 一 个 对 应 于 客户 的 Socket。 例 如 : 


ServerSocket server=null; 
try { 
server=new ServerSocket (1234) ; 
Socket socket-server.accept(); 
in=new BufferedReader (new InputStreamReader 
(socket.getInputStream()) ) ; 
out=new PrintWriter (socket.getOutputStream(),true) ; 
// 进 行 输入 输出 操作 . ………… - 
in.close(); 
out.close(); 
} catch (IOException e) { 
// TODO Auto-generated catch block 
e.printStackTrace(); 
b 


该 代码 表示 在 服务 器 端 创建 了 一 个 监听 1234 端口 的 ServerSocket 对 象 ， 当 该 端口 有 客户 
端 请 求 发 生 时 ， 则 创建 Socket 对 象 与 客户 端 进行 连接 ， 之 后 就 可 以 通过 输入 流 和 输出 流 与 客 
户 端 进行 数据 交换 。 当 然 ， 这 几 行 代码 仅 是 示例 代码 ， 只 能 处 理 一 个 客户 端 请 求 。 在 实际 的 
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工程 开发 中 ， 服 务 器 端的 处 理 方式 应 该 是 当 检测 到 有 客户 端 进行 请 求 时 建立 新 的 线程 与 客户 
端 进行 连接 。 


8.2.8 Socket 编程 实例 


通过 java.net 包 下 的 DatagramSocket 和 DatagramPacket 类 ， 可 以 方便 地 开发 基于 UDP 
协议 的 网 络 传输 应 用 程序 。 下 面 编 写 一 个 由 Android 手机 客户 端 向 PC 服务 器 端 发 送信 息 的 
小 程序 ， 客 户 端详 细 代码 记录 在 实例 SocketClientDemo 中 ， 服 务 器 端 由 纯 Java 开发 ， 详 细 
代码 在 实例 SocketServerDemo 中 ， 运 行 效果 如 图 8.5 所 示 。 


开始 发 送 数据 


8.5 Socket 编程 效果 
手机 客户 端 运行 效果 如 图 8.6 所 示 。 


string from the Android Client! 
string from the Android Client! 


string from the Android Client! 
string from the Android Client! 
string from the Android Client! 


图 8.6 手机 客户 端 运行 效果 
实例 SocketServerDemo 中 Server.java 具体 实现 代码 如 下 : 
package introduction.android.server; 
import java.io.IOException; 
import java.net.DatagramPacket; 
import java.net.DatagramSocket; 
import java.net.SocketException; 


public class Server { 


public static void main (String[] args) { 
// TODO Auto-generated method stub 
// 创建 一 个 DatagramSocket 对 象 ， 并 指定 监听 的 端口 号 
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DatagramSocket socket; 
try { 
socket=new DatagramSocket (12345) ; 
byte data[]=new byte[1024]; 
// 创建 一 个 空 的 DatagramPacket 对 象 
DatagramPacket packet=new DatagramPacket (data, 
data.length) ; 
// 使 用 receive 方法 接收 客户 端 所 发 送 的 数据 
while (true) { 
try { 
socket.receive (packet) ; 
String result=new String (packet.getData(), 
packet.getOffset(), packet.getLength()) ; 
System.out.println (result) ; 
) catch (IOException e) ( 
// TODO Auto-generated catch block 
e.printStackTrace(); 
} 


} 
} catch (SocketException e1) { 


// TODO Auto-generated catch block 
el.printStackTrace(); 


) 


Serverjava 在 PC 服务 器 端 建立 DatagramSocket 对 象 ， 并 监听 12345 端口 。 当 有 客户 端 
请 求 时 ， 从 该 端口 读 取 客 户 端 传 入 的 数据 ， 并 打印 出 来 。 

实例 SocketClientDemo 中 的 AndroidManifest.xml 中 需要 注册 访问 网 络 的 相关 权限 ， 代 码 
如 下 : 


<?xml version="1.0" encoding-"utf-8"?» 
«manifest xmlns:android-"http://schemas.android.com/apk/res/android" 
package="introduction.android.udpDemo" 
android: versionCode="1" 
android: versionName="1.0"> 
<uses-sdk android:minSdkVersion="4" /> 
<uses-permission 
android:name="android.permission.ACCESS_NETWORK_STATE"></uses-permission> 
<uses-permission android:name="android.permission. INTERNET"></uses- 
permission> 
«application android: icon="@drawable/icon" 
android: label="@string/app_name"> 
<activity android:name=".UdpClient" 
android: label="@string/app_name"> 
<intent-filter> 
<action android:name="android.intent.action.MAIN" /> 
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<category 


android:name="android.intent.category.LAUNCHER" /> 
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</intent-filter> 
</activity> 


</application> 
</manifest> 


实例 SocketClientDemo 中 UdpClient java 具体 实现 代码 如 下 : 


package introduction.android.udpDemo; 


import 
import 
import 


import 
import 
import 
import 
import 
import 
import 
import 
import 


public 


java.net.DatagramPacket; 
java.net.DatagramSocket; 
java.net.InetAddress; 


android.app.Activity; 
android.os.Bundle; 
android.os.Handler; 
android.os.Message; 
android.util.Log; 

android.view. View; 
android.view.View.OnClickListener; 
android.widget.Button; 
android.widget.EditText; 


class UdpClient extends Activity ( 


private Button btn listen; 

private EditText et; 

@Override 

public void onCreate (Bundle savedInstanceState) { 


super.onCreate (savedInstanceState) ; 
setContentView (R.layout.main) ; 
et= (EditText) findViewById (R.id.editText1) ; 
btn listen- (Button) findViewById (R.id.btn listen) ; 
btn listen.setOnClickListener (new OnClickListener()( 
GOverride 
public void onClick (View v) ( 
// TODO Auto-generated method stub 
et.setText (" 开 始 发 送 数据 ...") ; 


new ServerThread().start(); 


0: 


class ServerThread extends Thread { 


public void run(){ 
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try { 
// 首 先 创 建 一 个 DatagramSocket 对 象 
DatagramSocket socket=new DatagramSocket 
(12344) ; 
// 创 建 一 个 InetAddree， 自 己 测试 的 时 候 要 设置 成 自己 本 机 的 
IP 地 址 
InetAddress serverAddress-InetAddress.getByName 
("169254 3058") ; 
while (true) { 
String str="Hi, this is the string from 
the Android Client!"; 
byte data []-str.getBytes(); 
// 创 建 一 个 DatagramPacket 对 象 ， 并 指定 要 讲 这 个 数 
据 包 发 送 到 网 络 当中 的 哪个 地 址 ， 以 及 端口 号 
DatagramPacket packet=new DatagramPacket 
(data, data.length, serverAddress,12345) ; 
// 调 用 socket 对 象 的 send 方法 ， 发 送 数据 
socket .send (packet) ; 
Log.d ("server", "sending...") ; 
Thread.sleep (1000) ; 


} catch (Exception e) { 
// TODO Auto-generated catch block 
e.printStackTrace(); 


} 
} 


UdpClient java 在 手机 客户 端 创建 DatagramSocket 对象， 并 请 求 与 全 地 址 为 “169.254.31.8” 
的 主机 进行 UDP 连接 。 当 连接 建立 后 ， 将 要 传递 的 信息 封装 在 DatagramPacket 对 象 中 ， 并 
通过 DatagramSocketsend() 方 法 发 送出 去 。 


Bluetooth 通信 


8.3.4 Bluetooth 简介 


WEZ (Bluetooth) 技术 是 一 种 支持 设备 短 距离 通信 的 无 线 电 技术 ， 作 用 范围 在 10 OK Ze 
右 。 通 过 蓝牙 技术 可 以 在 移动 电话 、PDA、 无 线 耳 机 、 笔 记 本 电脑 等 众多 设备 之 间 进 行 无 线 
信息 的 交换 。 

1998 年 5 月 ， 爱 立信 、 诺 基 亚 、 东 艺 、IBM 和 英特尔 公司 五 家 著名 厂商 ， 在 联合 开展 短 
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程 无 线 通 信 技 术 的 标准 化 活动 时 提出 了 蓝牙 技术 。 蓝 牙 这 个 名 字 来 源 于 十 世纪 的 一 位 丹麦 国 
Æ Harald Blatand， 其 宗旨 是 提供 一 种 短 距离 、 低 成 本 的 无 线 传输 应 用 技术 。 利 用 “蓝牙 ” 
技术 ， 能 够 有 效 地 简化 移动 通信 终端 设备 之 间 的 通信 ， 也 能 够 成 功 地 简化 设备 与 Intemet 之 
间 的 通信 ， 从 而 数据 传输 变 得 更 加 迅速 高 效 ， 为 无 线 通信 拓宽 道路 。 蓝 牙 技术 基于 无 线 技 
术 ， 采 用 分 散 式 网 络 结构 以 及 快 跳 频 和 短 包 技 术 ， 支 持 点 对 点 通信 ， 使 用 了 ISM (Industrial 
Scientific Medical， 工 业 、 科 学 、 医 学 ) 频率 的 波段 (2.45GHz) ， 在 无 线 设备 的 电气 特性 支 
持 下 ， 通 过 特定 的 通信 协议 栈 进行 通信 。 

Android SDK 对 于 蓝牙 技术 从 2.0 版 本 的 开始 支持 。Android 包含 了 对 蓝牙 网 络 协议 栈 的 
支持 ， 这 使 得 蓝牙 设备 能 够 无 线 连接 其 他 蓝牙 设备 交换 数据 。Android 的 应 用 程序 框架 提供 
了 访问 蓝牙 功能 的 API， 这 些 API 使 得 应 用 程序 能 够 无 线 连接 其 他 蓝牙 设备 ， 实 现 点 对 点 及 
点 对 多 点 的 无 线 交 互 功能 。 

从 目前 来 看 ， 手 机 是 蓝牙 技术 的 最 大 应 用 领域 ， 也 是 已 经 有 实际 应 用 的 领域 。 几 乎 所 有 
的 Android 系统 手机 都 支持 蓝牙 技术 。 通 过 在 手机 中 植 入 蓝牙 技术 ， 可 以 实现 无 线 耳机 、 车 
载 电话 等 功能 ， 还 能 实现 手机 与 计算 机 或 与 其 他 手持 设备 的 无 电缆 连接 。 


8.3.2 Android 系统 的 蓝牙 通信 功能 


Android 系统 提供 蓝牙 API 包 android.bluetooth， 人 允许 手机 设备 通过 蓝牙 与 其 他 设备 进行 
无 线 连 接 。 
Android 的 蓝牙 API 可 提供 以 下 功能 : 
查找 并 配对 蓝牙 设备 。 
建立 RFCOMM 通道 。 
通过 服务 发 现 ( Device discovery) 与 其 他 无 线 设备 进行 连接 。 
与 其 他 设备 进行 蓝牙 数据 传输 。 
管理 多 个 蓝牙 连接 。 
需要 说 明 的 是 ，Android 模拟 器 不 支持 蓝牙 功能 ， 因 此 蓝牙 相关 的 应 用 程序 只 能 在 真 机 
上 调试 。 
要 使 用 蓝牙 功能 ， 需 要 在 AndroidManifestxml 中 声明 相应 权限 。 蓝 牙 权 限 有 两 种 ， 分 别 为 : 


<uses-permission android:name="android.permission.BLUETOOTH" /> 
或 者 
<uses-permission android:name="android.permission.BLUETOOTH ADMIN" /> 


如 果 想 在 应 用 程序 中 请 求 或 者 建立 蓝牙 连接 并 传递 数据 ， 必 须 声 明 Bluetooth 权限 。 如 果 
想 初 始 化 设备 发 现 功能 或 者 对 蓝牙 设置 进行 更 改 ， 则 必须 声明 BLUETOOTH. ADMIN 权限 。 
要 在 应 用 程序 中 使 用 蓝牙 功能 ， 必 须 保证 当前 设备 具有 蓝牙 并 且 启 用 该 功能 。 若 当前 设 
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备 支 持 蓝牙 ， 但 是 没有 启用 相关 功能 ， 则 需要 人 工 启 用 蓝牙 功能 。 首 先 使 用 
BluetoothAdapter 类 的 对 象 来 确认 设备 具有 蓝牙 功能 ， 然 后 使 用 Intent 开启 蓝牙 功能 。 相 关 代 


码 如 下 : 
BluetoothAdapter 
mBluetoothAdapter=BluetoothAdapter.getDefaultAdapter () ; 
if (mBluetoothAdapter==null) { 
// 设备 不 支持 蓝牙 功能 


return; 


} 
// 设 备 支持 蓝牙 功能 
if (!mBluetoothAdapter.isEnabled()) { 


// 用 于 启动 蓝牙 功能 的 Intent 
Intent enableBtIntent=new Intent 


(BluetoothAdapter.ACTION REQUEST ENABLE) ; 
startActivityForResult (enableBtIntent, REQUEST ENABLE BT) ; 


} 

startActivityForResult (enableBtIntent, REQUEST ENABLE BT) 调用 后 ， 会 显示 如 图 
8.7 所 示 的 对 话 框 ， 要 求 用 户 确认 是 否 启 用 蓝牙 功能 。 若 用 户 单 击 Yes, Ill) Android 系统 会 让 
用 蓝牙 功能 。 若 蓝牙 功能 启用 成 功 ， onActivityResult0 方 法 会 返回 RESULT OK; 若 蓝 牙 功 
能 启用 失败 或 者 用 户 单 击 No， 则 返回 RESULT_CANCELED。 


0 Bluetooth permission 
request 


An application on your phone 
is requesting permission to 


turn on Bluetooth. Do you 
want to do this? 


图 8.7 请 求 启用 蓝牙 功能 对 话 框 


通过 BluetoothAdapter 类 对 象 可 以 发 现 其 他 的 蓝牙 设备 。 在 启动 设备 发 现 服务 前 ， 应 该 
首先 对 配对 设备 列表 进行 查询 ， 以 确定 要 连接 的 无 线 设备 是 否 已 知 。 配 对 设备 列表 中 存储 了 
以 前 配对 过 的 蓝牙 设备 的 基本 信息 ， 如 设备 名 称 、 设 备 类 型 、 设 备 的 MAC 地 址 等 等 。 通 过 
设备 列表 查找 设备 可 以 节省 大 量 查 找 时 间 。 查 询 设 备 列表 的 代码 如 下 : 

Set<BluetoothDevice>pairedDevices=mBluetoothAdapter .getBondedDevices () ; 


// 已 配对 设备 列表 存在 


if (pairedDevices.size()>0) { 


// 列表 内 循环 查找 


for (BluetoothDevice device : pairedDevices) { 


// 将 列表 内 的 设备 名 字 添 加 到 ArrayAdapter 中 
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mArrayAdapter.add (device.getName()+"\n"+device.getAddress()) ; 


} 


当 设 备 列表 中 未 发 现 要 连接 的 设备 时 ， 需 要 启动 设备 发 现 服务 来 发 现 远 端 蓝牙 设备 ， 扫 
描 周 围 无 线 设 备 的 时 间 为 12 秒 钟 左右 。 启 动 设备 发 现 服务 的 方法 很 简单 ， 只 要 调用 
startDiscovery() 方 法 即 可 。 但 是 为 了 接收 设备 发 现 服务 返回 的 设备 信息 ， 应 用 程序 需要 注册 
用 于 接收 含有 ACTION FOUND 消息 的 Intent 的 BroadcastReceiver 。 代 码 如 下 : 


private final BroadcastReceiver mReceiver=new BroadcastReceiver () { 
public void onReceive (Context context, Intent intent) { 
String action-intent.getAction(); 
// 发 现 服务 发 现 远 端 设备 时 
if (BluetoothDevice.ACTION FOUND.equals (action) ) ii 
// \K Intent 对 象 中 获取 BluetoothDevice 对 象 信息 
BluetoothDevice device-intent.getParcelableExtra 
(BluetoothDevice.EXTRA DEVICE) ; 
// 当 发 现 的 新 设备 不 存在 于 设备 配对 列表 中 时 ， 将 设备 的 名 字 和 地 址 添加 到 
ArrayAdapter 中 
if (device.getBondState() !=BluetoothDevice.BOND_BONDED) { 
mArrayAdapter.add (device.getName()+"\n"+device.getAddress()) ; 


} 
} 


} 
}; 
// 注 册 BroadcastReceiver 
IntentFilter filter=new IntentFilter (BluetoothDevice.ACTION_FOUND) ; 


registerReceiver (mReceiver, filter) ; 


使 用 registerReceiver() 方 式 注册 的 BroadcastReceiver， 在 应 用 程序 结束 时 要 记得 注销 。 

蓝牙 设备 间 建 立 连接 的 过 程 和 TOP 连接 的 过 程 很 相似 。 服 务 器 端 提供 BluetoothServerSocket 
类 在 服务 器 端 进行 监听 ， 当 有 客户 端 连 接 请 求 时 用 于 建立 连接 ;客户 端 提供 BluetoothSocket 
类 用 于 对 蓝牙 服务 提交 连接 请 求 ， 并 建立 连接 。 

服务 器 端 处 理 连 接 请 求 的 示例 代码 如 下 : 


private class AcceptThread extends Thread { 
private final BluetoothServerSocket mmServerSocket ; 
private final String NAME-"MY BLUETOOTH SERVICE"; 
public AcceptThread()([ 
BluetoothServerSocket tmp-null; 
try { 
// MY UUID 用 于 唯一 标识 当前 的 蓝牙 服务 ， 在 建立 连接 时 会 被 客户 端 使 用 
tmp-mBluetoothAdapter.listenUsingRfcommWithServiceRecord 
(NAME, MY UUID) ; 
) catch (IOException e) ( ] 
mmServerSocket-tmp; 
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} 
public void run(){ 
BluetoothSocket socket-null; 
// 保持 监听 状态 ， 并 阻塞 线程 ， 当 连接 建立 时 返回 
while (true) { 
EVE 
socket=mmServerSocket .accept () ; 
) catch (IOException e) { 
break; 


} 

// 连接 已 经 建立 

if (socket !=null) { 
// 在 单独 的 线程 中 对 连接 进行 管理 ， 本 线程 结束 
manageConnectedSocket (socket) ; 
mmServerSocket.close(); 


break; 
} 
} 
} 
public void cancel () { 
try { 
mmServerSocket .close() ; 
) catch (IOException e) { } 
} 


} 


UUID (Universally Unique Identifier) 为 通用 唯一 识别 码 ， 是 一 个 128 位 的 字符 串 ， 在 
该 处 用 于 唯一 标识 蓝牙 服务 。 客 户 端 通过 该 UUID 搜寻 到 该 服务 。 
客户 端 用 于 请 求 连接 的 示例 代码 如 下 : 


private class ConnectThread extends Thread { 
private final BluetoothSocket mmSocket; 
private final BluetoothDevice mmDevice; 


public ConnectThread (BluetoothDevice device) { 
BluetoothSocket tmp=null; 
mmDevice=device; 
// 通过 BluetoothDevice #17 BluetoothSocket 对 象 
try { 
tmp-device.createRfcommSocketToServiceRecord (MY UUID) ; 
) catch (IOException e) { } 


mmSocket-tmp; 


} 


public void run() { 
// 发 现 服务 会 减 慢 连 接 建立 速度 ， 因 此 关闭 掉 


mBluetoothAdapter.cancelDiscovery () ; 
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try { 
// 请 求 连接 ， 该 操作 会 阻塞 线程 
mmSocket .connect () ; 
) catch (IOException connectException) { 
// 连接 建立 失败 
try { 
mmSocket .close () ; 
) catch (IOException closeException) { } 
return; 


} 
// 连 接 已 建立 ， 在 单独 的 线程 中 对 连接 进行 管理 
manageConnectedSocket (mmSocket) ; 


} 
public void cancel () { 
try { 
mmSocket .close() ; 
) catch (IOException e) { } 
} 


} 


由 于 连接 建立 的 过 程 会 阻塞 进程 ， 属 于 耗 时 操作 ， 因 此 连接 的 建立 和 管理 都 需要 在 单独 
的 线程 中 进行 。 在 实际 的 工程 开发 过 程 中 ， 建 立 蓝牙 连接 的 技巧 是 将 每 个 蓝牙 设备 初始 化 为 
服务 器 端 并 监听 连接 ， 这 样 每 个 设备 都 可 以 自动 在 服务 器 端 和 客户 端 之 间 进 行 转化 。 

从 已 经 建立 的 连接 中 读 取 和 写 入 数据 的 过 程 也 属于 耗 时 操作 ， 因 此 也 应 该 在 单独 的 线程 
中 进行 。 通 过 getInputStream() 和 getOutputStream() 方 法 可 以 获取 到 输入 流 InputStream 和 输出 
流 OutputStream， 通 过 read (byte[]) 和 write Cbyte[ 方法 可 以 对 数据 进行 读 写 。 示 例 代 码 
如 下 : 

private class ConnectedThread extends Thread { 

private final BluetoothSocket mmSocket ; 


private final InputStream mmInStream; 
private final OutputStream mmOutStream; 


public ConnectedThread (BluetoothSocket socket) { 
mmSocket=socket ; 
InputStream tmpIn-null; 
OutputStream tmpOut-null; 


// Get the input and output streams, using temp objects because 
// member streams are final 
try { 
tmpIn=socket .getInputStream() ; 
tmpOut=socket .getOutputStream() ; 
} catch (IOException e) { } 
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mmInStream-tmpIn; 
mmOutStream-tmpOut ; 


} 


public void run(){ 
byte[] buffer-new byte[1024]; 
// 持续 监听 InputStream 
while (true) { 
try { 
// 读 取 InputStream 的 数据 
bytes=mmInStream.read (buffer) ; 


// 更 新 UI 
mHandler.obtainMessage (MESSAGE READ, bytes, -1, 


buffer) 
.sendToTarget () ; 
) catch (IOException e) { 
break; 
} 
} 
} 
public void write (byte[] bytes) { 
try { 
mmOutStream.write (bytes) ; 
) catch (IOException e) { } 
} 
public void cancel () { 
try { 
Demo 
mmSocket.close(); Rope 
) catch (IOException e) ( } 
} 
} 


83.3 ”蓝牙 通信 实例 


实例 BluetoothDemo 演示 了 使 用 蓝牙 功能 对 其 他 蓝牙 
设备 进行 搜寻 、 连 接 并 进行 数据 传输 的 过 程 。 该 应 用 程序 
运行 效果 如 图 8.8 所 示 。 

该 视图 整体 使 用 了 LinearLayout 布局 ， 使 用 ListView 
显示 聊天 内 容 ， 下 方 的 横向 LinearLayout 布局 中 放置 了 一 | 一 
个 用 于 输入 文本 的 EditText 和 一 个 按钮 。 对 应 的 布局 文件 图 8.8 实例 BluctoothDemo 运行 效果 
main.xml 内 容 如 下 : 


<?xml version-"1.0" encoding-"utf-8"?» 
«LinearLayout 
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xmlns:android="http://schemas.android.com/apk/res/android" 
xmlns :myapp="http: //schemas .android. com/apk/res/com.android.Bluetoot 
hChat" 
android:orientation-"vertical" 
android:layout width- "match parent" 
android:layout height-"match parent" 
android:background="@drawable/bg01" 


«ListView android:id="@+id/in" 
android:layout width-"match parent" 
android:layout height-"match parent" 
android:stackFromBottom- "true" 
android: transcriptMode="alwaysScroll" 
android: layout_weight="1" 
/> 
<LinearLayout 
android:orientation- "horizontal" 
android:layout width-"match parent" 
android:layout height-"wrap content" 
> 
<EditText android: id="@+id/edit_text_out" 
android:layout width-"wrap content" 
android:layout height- "wrap content" 
android:layout weight-"1" 
android:layout gravity- "bottom" 
/> 
«Button android: id="@+id/button_send" 
android:layout width-"wrap content" 
android:layout height- "wrap content" 
android:text- "Gstring/send" 
/> 
</LinearLayout> 
</LinearLayout> 


实例 BluetoothDemo 的 AndroidManifest.xml 文件 内 容 如 下 : 


<?xml version-"1.0" encoding="utf-8"?> 
«manifest xmlns:android="http: //schemas.android. com/apk/res/android" 
package= "introduction. android. BluetoothChat" 
android: versionCode="1" 
android: versionName="1.0"> 
<uses-sdk minSdkVersion="14" /> 
<uses-permission android:name="android.permission.BLUETOOTH_ADMIN" 
/> 


<uses-permission android:name="android.permission.BLUETOOTH" /> 
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android:configChanges="orientation |keyboardHidden"> 


<intent-filter> 


<action android:name="android.intent.action.MAIN" /> 


<category 


</intent-filter> 
</activity> 


<activity android:name=".DeviceList" 


android: label="@string/select_device" 
android: theme="@android:style/Theme. Dialog" 
android: configChanges="orientation/keyboardHidden" /> 


</application> 
</manifest> 


实例 BluetoothDemo 的 主 Activity Jj BluetoothChat， 其 对 应 的 文件 内 容 如 下 : 


package introduction.android.BluetoothChat ; 


import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 


public 


android.app.Activity; 
android.bluetooth.BluetoothAdapter; 
android.bluetooth.BluetoothDevice; 
android.content.Intent; 
android.os.Bundle; 
android.os.Handler; 
android.os.Message; 
android.view.KeyEvent; 
android.view.Menu; 
android.view.MenuInflater; 
android.view.MenuItem; 
android.view.View; 
android.view.View.OnClickListener; 
android.view.Window; 
android.view.inputmethod.EditorInfo; 
android.widget.ArrayAdapter; 
android.widget.Button; 
android.widget.EditText; 
android.widget.ListView; 
android.widget.TextView; 
android.widget.Toast; 


class BluetoothChat extends Activity 
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public static final int MESSAGE STATE CHANGE-1; 
public static final int MESSAGE_READ=2; 

public static final int MESSAGE WRITE-3; 

public static final int MESSAGE DEVICE NAME-4; 
public static final int MESSAGE TOAST=5; 

public static final String DEVICE_NAME="device name"; 
public static final String TOAST="toast"; 

private static final int REQUEST CONNECT DEVICE-1; 
private static final int REQUEST ENABLE BT=2; 
private TextView mTitle; 

private ListView mConversationView; 

private EditText mOutEditText; 

private Button mSendButton; 

private String mConnectedDeviceName-null; 

private ArrayAdapter<String>mConversationArrayAdapter; 
private StringBuffer mOutStringBuffer; 

private BluetoothAdapter mBluetoothAdapter-null; 
private ChatService mChatService-null; 


@Override 
public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState) ; 


// 设置 窗口 布局 为 自 定义 标题 
requestWindowFeature (Window.FEATURE CUSTOM TITLE) ; 
setContentView (R.layout.main) ; 


// 设置 窗口 标题 布局 文件 
getWindow().setFeatureInt (Window.FEATURE CUSTOM TITLE, 
R.layout.custom title) ; 


mTitle- (TextView) findViewById (R.id.title left text) ; 
mTitle.setText (R.string.app name) ; 
mTitle- (TextView) findViewById (R.id.title right text) ; 


// 得 到 本 地 蓝牙 适配器 
mBluetoothAdapter-BluetoothAdapter.getDefaultAdapter(); 


// 若 当前 设备 不 支持 蓝牙 功能 
if (mBluetoothAdapter==null) { 
Toast.makeText (this, "蓝牙 不 可 用 "， 


Toast .LENGTH LONG) .show() ; 
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@Override 
public void onStart () { 
super.onStart () ; 
if (!mBluetoothAdapter.isEnabled()) { 
// 若 当 前 设备 蓝牙 功能 未 开启 ， 则 开启 蓝牙 功能 
Intent enableIntent=new Intent ( 
BluetoothAdapter.ACTION REQUEST ENABLE) ; 
StartActivityForResult (enableIntent, 
REQUEST ENABLE BT) ; 


) eise ( 
if (mChatService--null) 
setupChat () ; 
} 
} 
@Override 


public synchronized void onResume() { 
super .onResume () ; 


if (mChatService !=null) { 
if (mChatService.getState()--ChatService.STATE NONE) { 


mChatService.start () ; 


} 
private void setupChat () { 
mConversationArrayAdapter=new ArrayAdapter<String> (this, 
R. layout .message) ; 
mConversationView= (ListView) findViewById (R.id.in) ; 


mConversationView.setAdapter (mConversationArrayAdapter) ; 


mOutEditText= (EditText) findViewById (R.id.edit text out) ; 
moutEditText.setOnEditorActionListener (mWriteListener) ; 


mSendButton- (Button) findViewById (R.id.button send) ; 
mSendButton.setOnClickListener (new OnClickListener () { 


public void onClick (View v) { 


TextView view= (TextView) findViewByld 
(R.id.edit text out) ; 
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String message=view.getText () .toString() ; 
sendMessage (message) ; 


DE: 
mChatService=new ChatService (this, mHandler) ; 


mOutStringBuffer=new StringBuffer ("") ; 


@Override 
public synchronized void onPause() { 
super.onPause(); 


@Override 
public void onstop() { 
super.onStop () ; 


@Override 
public void onDestroy() { 
super.onDestroy () ; 


if (mChatService !-null) 
mChatService.stop(); 


} 


private void ensureDiscoverable() { 


if 
(mBluetoothAdapter.getScanMode()!-BluetoothAdapter.SCAN MODE CONNECTABLE D 


ISCOVERABLE) ( 
Intent discoverableIntent-new Intent ( 


BluetoothAdapter.ACTION REQUEST DISCOVERABLE) ; 
discoverableIntent.putExtra ( 


BluetoothAdapter.EXTRA DISCOVERABLE DURATION, 300) ; 
startActivity (discoverableIntent) ; 


} 
} 


private void sendMessage (String message) { 
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if (mChatService.getState()!-ChatService.STATE CONNECTED) { 


Toast .makeText (this, R.string.not connected, 
Toast . LENGTH_SHORT) 


-Show() ; 
return; 


} 


if (message.length()>0) { 


byte[] send-message.getBytes(); 
mChatService.write (send) ; 


moutStringBuffer.setLength (0) ; 
mOutEditText.setText (mOutStringBuffer) ; 


private TextView.OnEditorActionListener mWriteListener-new 
TextView.OnEditorActionListener()( 


public boolean onEditorAction (TextView view, int actionId, 
KeyEvent event) { 


if (actionId--EditorInfo.IME NULL 
&& event.getAction()--KeyEvent.ACTION UP) { 


String message=view.getText () .toString() ; 
sendMessage (message) ; 


return true; 
hi 


private final Handler mHandler=new Handler () { 
GOverride 


public void handleMessage (Message msg) { 
switch (msg.what) { 


case MESSAGE STATE CHANGE: 


switch (msg.arg1) { 
case ChatService.STATE CONNECTED: 
mTitle.setText 
(R.string.title connected to) ; 
mTitle.append (mConnectedDeviceName) ; 


mConversationArrayAdapter.clear(); 
break; 


case ChatService.STATE CONNECTING: 
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(R.string.title_connecting) ; 


mTitle.setText 


break; 
case ChatService.STATE LISTEN: 
case ChatService.STATE NONE: 
mTitle.setText 
(R.string.title not connected) ; 
break; 
) 
break; 
case MESSAGE WRITE: 
byte[] writeBuf- (byte[]) msg.obj; 


String writeMessage-new String (writeBuf) ; 
mConversationArrayAdapter.add (" 我 : 


"+writeMessage) ; 

break; 

case MESSAGE READ: 

byte[] readBuf- (byte[]) msg.obj; 

String readMessage-new String (readBuf, 0, 
msg.argl) ; 

mConversationArrayAdapter.add 
(mConnectedDeviceName+": " 


+readMessage) ; 
break; 
case MESSAGE_DEVICE_NAME: 


mConnectedDeviceName=msg.getData() .getString 
(DEVICE_NAME) ; 
Toast .makeText (getApplicationContext (), 
"链接 到 "«mConnectedDeviceName, 
Toast . LENGTH_SHORT) 
. show () ; 
break; 
case MESSAGE TOAST: 
Toast.makeText (getApplicationContext(), 
msg.getData().getString (TOAST) , 
Toast.LENGTH SHORT) 
.show() ; 
break; 


}; 


public void onActivityResult (int requestCode, int resultCode, 
Intent data) { 
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switch (requestCode) { 
case REQUEST CONNECT DEVICE: 


if (resultCode--Activity.RESULT OK) { 


String address-data.getExtras().getString ( 
DeviceList.EXTRA DEVICE ADDRESS) ; 


BluetoothDevice device-mBluetoothAdapter 
-getRemoteDevice (address) ; 


mChatService.connect (device) ; 


} 


break; 
case REQUEST ENABLE BT: 


if (resultCode==Activity.RESULT_OK) { 


setupChat () ; 
} else { 


Toast .makeText (this, 


R.string.bt_not_enabled_leaving, 
Toast .LENGTH_ SHORT) .show() ; 


finish(); 


Goverride 
public boolean onCreateOptionsMenu (Menu menu) { 


MenuInflater inflater-getMenuInflater(); 
inflater.inflate (R.menu.option menu, menu) ; 


return true; 


Goverride 
public boolean onOptionsItemSelected (MenuItem item) { 


switch (item.getItemId()) { 
case R.id.scan: 


Intent serverIntent-new Intent (this, 


DeviceList.class) ; 
startActivityForResult (serverIntent, 


REQUEST CONNECT DEVICE) ; 
return true; 
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} 


case R.id.discoverable: 


ensureDiscoverable(); 
return true; 


case R.id.back: 


finish(); 
System.exit (0) ; 
return true; 


} 


return false; 


Activity BluetoothChat 的 onCreate() 方 法 检查 当前 设备 是 否 支持 蓝牙 功能 ， 并 得 到 的 本 地 
的 BluetoothAdapter 设备 。 在 onStart0 中 检查 是 否 启用 了 蓝牙 功能 ， 若 未 启用 则 请 求 启用 ， 
然后 通过 setupChat0 方 法 对 界面 中 的 控件 进行 初始 化 增加 单 击 监 听 器 等 ，BluetoothChat 创建 
了 ChatService 对 象 ， 该 对 象 在 整个 应 用 过 程 中 存在 ， 并 完成 了 蓝牙 连接 的 建立 、 消 息 发 送 
与 接收 等 功能 。 

ChatService.java 代码 如 下 : 


package introduction.android.BluetoothChat ; 


import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 


public 


java.io. IOException; 
java.io.InputStream; 
java.io.OutputStream; 
java.util.UUID; 
android.bluetooth.BluetoothAdapter; 
android.bluetooth.BluetoothDevice; 
android.bluetooth.BluetoothServerSocket; 
android.bluetooth.BluetoothSocket; 
android.content.Context; 
android.os.Bundle; 
android.os.Handler; 
android.os.Message; 


class ChatService ( 


private static final String NAME-"BluetoothChat"; 


// UUID--> 通 用 唯一 识别 码 , 能 唯一 的 辨识 资讯 


private static final UUID MY UUID-UUID 
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private final BluetoothAdapter mAdapter; 
private final Handler mHandler; 

private AcceptThread mAcceptThread; 
private ConnectThread mConnectThread; 
private ConnectedThread mConnectedThread; 
private int mState; 


public static final int STATE NONE=0; 
public static final int STATE LISTEN=1; 
public static final int STATE CONNECTING=2; 
public static final int STATE CONNECTED=3; 


public ChatService (Context context, Handler handler) { 
mAdapter-BluetoothAdapter.getDefaultAdapter(); 
mState-STATE NONE; 
mHandler-handler; 


} 


private synchronized void setState (int state) { 


mState=state; 
mHandler.obtainMessage (BluetoothChat.MESSAGE STATE CHANGE, 


.sendToTarget () ; 


public synchronized int getState() { 
return mState; 
} 


public synchronized void start () { 


if (mConnectThread !=null) { 
mConnectThread.cancel () ; 
mConnectThread-null; 


} 


if (mConnectedThread !-null) { 
mConnectedThread.cancel () ; 
mConnectedThread-null; 


} 


if (mAcceptThread==null) { 
mAcceptThread=new AcceptThread () ; 
mAcceptThread.start () ; 
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setState (STATE LISTEN) ; 


} 


// 取消 CONNECTING 和 CONNECTED 状态 下 的 相关 线程 ， 然 后 运行 新 的 


mConnectThread 线程 
public synchronized void connect (BluetoothDevice device) 1 


if (mState--STATE CONNECTING) { 
if (mConnectThread !-null) { 
mConnectThread.cancel(); 
mConnectThread-null; 


} 


if (mConnectedThread !=null) { 
mConnectedThread.cancel () ; 
mConnectedThread-null; 


} 


mConnectThread=new ConnectThread (device) ; 


mConnectThread. start () ; 
setState (STATE CONNECTING) ; 


) 
// 开启 一 个 ConnectedThread 来 管理 对 应 的 当前 连接 。 之 前 先 取消 任意 现存 的 


mConnectThread 、 
// mConnectedThread 、 mAcceptThread 线程 ， 然 后 开启 新 
mConnectedThread ， 传 入 当前 刚刚 接受 的 
// socket 连接 。 
// 最 后 通过 Handler 来 通知 UI 连接 
public synchronized void connected (BluetoothSocket socket, 
BluetoothDevice device) { 


if (mConnectThread !-null) { 
mConnectThread.cancel () ; 
mConnectThread-null; 


} 


if (mConnectedThread !-null) { 
mConnectedThread.cancel () ; 
mConnectedThread-null; 


} 


if (mAcceptThread !=null) { 
mAcceptThread.cancel () ; 
mAcceptThread-null; 
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mConnectedThread=new ConnectedThread (socket) ; 
mConnectedThread. start () ; 


Message msg-mHandler.obtainMessage 
(BluetoothChat.MESSAGE DEVICE NAME) ; 


Bundle bundle-new Bundle(); 
bundle.putString (BluetoothChat.DEVICE NAME, 


device.getName()) ; 
msg.setData (bundle) ; 
mHandler.sendMessage (msg) ; 


setState (STATE CONNECTED) ; 


} 


// 停止 所 有 相关 线程 ， 设 当前 状态 为 NONE 
public synchronized void stop(){ 


if (mConnectThread !=null) { 
mConnectThread.cancel(); 
mConnectThread-null; 


) 


if (mConnectedThread !-null) { 
mConnectedThread.cancel(); 
mConnectedThread-null; 


) 


if (mAcceptThread !-null) { 
mAcceptThread.cancel(); 
mAcceptThread-null; 


} 


setState (STATE NONE) ; 


} 


// 在 STATE CONNECTED 状态 下 ， 调 用 mConnectedThread 里 的 write 方法 ， 写 入 


byte 
public void write (byte[] out) { 


ConnectedThread r; 


synchronized (this) { 
if (mState !=STATE CONNECTED) 


return; 
r=mConnectedThread; 


} 


r.write (out) ; 
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// 连接 失败 的 时 候 处 理 ， 通 知 ui ， 并 设 为 STATE_LISTEN 状态 
private void connectionFailed(){ 
setState (STATE LISTEN) ; 


Message msg-mHandler.obtainMessage 
(BluetoothChat .MESSAGE TOAST) ; 
Bundle bundle=new Bundle() ; 
bundle.putString (BluetoothChat.TOAST, "链接 不 到 设备 ") ; 
msg.setData (bundle) ; 
mHandler.sendMessage (msg) ; 


) 
// 当 连 接 失 去 的 时 候 ， 设 为 STATE LISTEN 状态 并 通知 UI 


private void connectionLost () { 
setState (STATE LISTEN) ; 


Message msg-mHandler.obtainMessage 
(BluetoothChat.MESSAGE TOAST) ; 

Bundle bundle-new Bundle(); 

bundle.putString (BluetoothChat.TOAST, "设备 链接 中 断 ") ; 

msg.setData (bundle) ; 

mHandler.sendMessage (msg) ; 


) 
// 创建 监听 线程 ， 准 备 接受 新 连接 。 使 用 阻塞 方式 ， 调 用 


BluetoothServerSocket .accept () 
private class AcceptThread extends Thread { 


private final BluetoothServerSocket mmServerSocket; 


public AcceptThread() { 
BluetoothServerSocket tmp-null; 


try { 
tmp=mAdapter 
.listenUsingRfcommWithServiceRecord 
(NAME, MY UUID) ; 
} catch (IOException e) { 


} 


mmServerSocket=tmp; 


} 
public void run() { 


setName ("AcceptThread") ; 
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// 构造 函数 里 通过 BluetoothDevice.createRfcommSocketToServiceRecord(), 

// 从 待 连接 的 device 产生 BluetoothSocket. 然后 在 run 方法 中 connect , 

// 成 功 后 调用 BluetoothChatSevice 的 connected() 方 法 。 定 义 cancel () 在 关闭 
线程 时 能 够 关闭 相关 socket 。 


private class ConnectThread extends Thread { 
private final BluetoothSocket mmSocket; 
private final BluetoothDevice mmDevice; 


public ConnectThread (BluetoothDevice device) { 
mmDevice=device; 
BluetoothSocket tmp=null; 


try { 
tmp=device.createRfcommSocketToServiceRecord 
(MY_UUID) ; 
} catch (IOException e) { 


} 


mmSocket-tmp; 
} 


public void run() { 


setName ("ConnectThread") ; 
mAdapter.cancelDiscovery () ; 


try { 


mmSocket .connect () ; 
) catch (IOException e) { 


connectionFailed() ; 


try { 
mmSocket.close(); 
} catch (IOException e2) { 


} 


ChatService.this.start(); 
return; 


} 


synchronized (ChatService.this) { 
mConnectThread-null; 


} 
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connected (mmSocket, mmDevice) ; 


} 


public void cancel () { 


try { 
mmSocket.close(); 
) catch (IOException e) { 


} 
) 


// 双方 蓝牙 连接 后 一 直 运行 的 线程 。 构 造 函 数 中 设置 输入 输出 流 。 

// Run 方法 中 使 用 阻塞 模式 的 InputStream.read () 循环 读 取 输入 流 ， 

// 然后 post 到 UI 线程 中 更 新 聊天 消息 。 也 提供 了 write () 将 聊天 消息 写 入 输出 流传 
输 至 对 方 ， 传 输 成 功 后 回 写 入 UI 线程 。 最 后 cancel () 关 闭 连接 的 socket 


private class ConnectedThread extends Thread { 
private final BluetoothSocket mmSocket; 
private final InputStream mmInStream; 
private final OutputStream mmOutStream; 


public ConnectedThread (BluetoothSocket socket) { 


mmSocket=socket ; 
InputStream tmpIn-null; 
OutputStream tmpOut=null; 


try { 
tmpIn=socket .getInputStream() ; 
tmpOut=socket .getOutputStream() ; 
} catch (IOException e) { 


} 


mmInStream-tmpIn; 
mmOutStream=tmpOut ; 


) 


public void run() { 


byte[] buffer=new byte[1024]; 
int bytes; 


while (true) { 
try { 
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bytes-mmInStream.read (buffer) ; 


mHandler.obtainMessage 
(BluetoothChat.MESSAGE READ, bytes, 
-1, buffer) .sendToTarget(); 
} catch (IOException e) { 


connectionLost () ; 


break; 
} 
} 
} 
public void write (byte[] buffer) { 
try { 


mmOutStream.write (buffer) ; 


mHandler.obtainMessage 
(BluetoothChat.MESSAGE WRITE, -1, -1, 
buffer) .sendToTarget(); 
} catch (IOException e) { 


} 


public void cancel () { 
try { 
mmSocket .close(); 
) catch (IOException e) { 


} 


DeviceList 用 于 显示 蓝牙 设备 列表 ， 并 返回 蓝牙 设备 信息 。DeviceListjava 代码 如 下 : 


package introduction.android.BluetoothChat ; 


import java.util.Set; 

import android.app.Activity; 

import android.bluetooth.BluetoothAdapter; 
import android.bluetooth.BluetoothDevice; 
import android.content .BroadcastReceiver; 
import android.content .Context ; 

import android.content.Intent; 
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import android.content.IntentFilter; 
import android.os.Bundle; 

import android.view.View; 

import android.view.Window; 

import android.view.View.OnClickListener; 
import android.widget .AdapterView; 

import android.widget .ArrayAdapter; 
import android.widget .Button; 

import android.widget .ListView; 

import android.widget .TextView; 

import android.widget .AdapterView.OnItemClickListener; 


public class DeviceList extends Activity { 
public static String EXTRA DEVICE ADDRESS-"device address"; 
private BluetoothAdapter mBtAdapter; 
private ArrayAdapter<String>mPairedDevicesArrayAdapter; 
private ArrayAdapter<String>mNewDevicesArrayAdapter ; 


@Override 
protected void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState) ; 


requestWindowFeature (Window.FEATURE INDETERMINATE PROGRESS) ; 
setContentView (R.layout.device list) ; 


setResult (Activity.RESULT CANCELED) ; 


Button scanButton- (Button) findViewById (R.id.button scan) ; 
scanButton.setOnClickListener (new OnClickListener() { 
public void onClick (View v) { 
doDiscovery () ; 
v.setVisibility (View.GONE) ; 


s 


mPairedDevicesArrayAdapter-new ArrayAdapter<String> (this, 
R.layout.device name) ; 

mNewDevicesArrayAdapter-new ArrayAdapter<String> (this, 
R.layout.device name) ; 


ListView pairedListView- (ListView) findViewById 

(R.id.paired devices) ; 
pairedListView.setAdapter (mPairedDevicesArrayAdapter) ; 
pairedListView.setOnItemClickListener (mDeviceClickListener) ; 


ListView newDevicesListView- (ListView) findViewById 
(R.id.new devices) ; 
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newDevicesListView.setAdapter (mNewDevicesArrayAdapter) ; 
newDevicesListView.setOnItemClickListener 
(mDeviceClickListener) ; 


IntentFilter filter=new IntentFilter 
(BluetoothDevice.ACTION FOUND) ; 
this.registerReceiver (mReceiver, filter) ; 


filter-new IntentFilter 
(BluetoothAdapter.ACTION DISCOVERY FINISHED) ; 
this.registerReceiver (mReceiver, filter) ; 


mBtAdapter-BluetoothAdapter.getDefaultAdapter(); 


Set«BluetoothDevice»pairedDevices-mBtAdapter.getBondedDevices(); 


if (pairedDevices.size()»0) { 
findViewById (R.id.title paired devices) .setVisibility 
(View.VISIBLE) ; 
for (BluetoothDevice device : pairedDevices) { 
mPairedDevicesArrayAdapter.add 
(device.getName ()+"\n" 


} 
} else { 
String noDevices-getResources().getText 
(R.string.none paired) 


*device.getAddress()) ; 


.toString(); 
mPairedDevicesArrayAdapter.add (noDevices) ; 


Goverride 
protected void onDestroy () { 
super.onDestroy () ; 


if (mBtAdapter !-null) { 
mBtAdapter.cancelDiscovery(); 


} 


this.unregisterReceiver (mReceiver) ; 


} 
private void doDiscovery() { 


set ProgressBarIndeterminateVisibility (true) ; 
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setTitle (R.string.scanning) ; 


findViewById (R.id.title new devices) .setVisibility 
(View.VISIBLE) ; 


if (mBtAdapter.isDiscovering()) { 
mBtAdapter.cancelDiscovery () ; 


mBtAdapter.startDiscovery () ; 


private OnItemClickListener mDeviceClickListener=new 
OnItemClickListener () { 
public void onItemClick (AdapterView<?>av, View v, int arg2, 
long arg3) { 


mBtAdapter.cancelDiscovery(); 


String info- ( (TextView) v) .getText() .toString() ; 
String address-info.substring (info.length()- 17) ; 


Intent intent-new Intent(); 
intent.putExtra (EXTRA DEVICE ADDRESS, address) ; 


setResult (Activity.RESULT OK, intent) ; 
finish(); 


) 


private final BroadcastReceiver mReceiver-new BroadcastReceiver () { 
GOverride 
public void onReceive (Context context, Intent intent) { 
String action-intent.getAction(); 


if (BluetoothDevice.ACTION FOUND.equals (action) ) { 


BluetoothDevice device-intent 


.getParcelableExtra 
(BluetoothDevice.EXTRA DEVICE) ; 


if 
(device.getBondState()!-BluetoothDevice.BOND BONDED) { 


mNewDevicesArrayAdapter.add 
(device.getName()+"\n" 
+device.getAddress()) ; 
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} else if (BluetoothAdapter.ACTION DISCOVERY FINISHED 
-equals (action) ) { 
setProgressBarIndeterminateVisibility (false) ; 
setTitle (R.string.select device) ; 
if (mNewDevicesArrayAdapter.getCount ()==0) ( 
String noDevices-getResources ().getText ( 


R.string.none found) .toString(); 
mNewDevicesArrayAdapter.add (noDevices) ; 
} 


5.4 WIFURS 


8.4.4 WIFI 简介 


WIFI (Wireless Fidelity) 是 一 种 可 以 将 个 人 电脑 、 手 持 设 备 〈 如 PDA, PBL) 等 终端 
以 无 线 方式 互相 连接 的 技术 。WIFI 是 由 一 个 名 为 “无 线 以 太 网 相 容 联盟 ” Wireless 
Ethernet Compatibility Alliance, WECA) 的 组 织 所 发 布 的 业界 术语 ， 中 文 译 为 “无 线 相 容 认 

随 着 通信 技术 的 发 展 ， 以 及 IEEE 802.11a 及 IEEE 802.11g 等 标准 的 出 现 ， 现 在 IEEE 
802.11 标准 已 被 统称 作 WIFI. 1997 年 IEEE 802.11 第 一 个 版 本 发 表 ， 其 中 定义 了 介质 访问 接 
入 控制 层 (MAC) 和 物理 层 。 物 理 层 定义 了 工作 在 2.4GHz 的 ISM 频 段 上 的 两 种 无 线 调频 
方式 和 一 种 红外 传输 的 方式 ， 总 数据 传输 速率 设计 为 2Mbits。 两 个 设备 之 间 的 通信 可 以 自 
由 直接 Cad hoc) 的 方式 进行 ， 也 可 以 在 基站 (Base Station, BS) 或 者 访问 点 (Access 
Point, AP) 的 协调 下 进行 。1999 年 加 上 了 两 个 补充 版 本 : 802.11a 定义 了 一 个 在 5GHz ISM 
频段 上 的 数据 传输 速率 可 达 54Mbit/s 的 物理 层 ，802.11b 定义 了 一 个 在 2.4GHz 的 ISM 频段 
上 但 数据 传输 速率 高 达 11Mbit/s 的 物理 屋 。WIFI 的 正式 名 称 是 “IEEE802.11b”。 

WIFI 是 一 种 帮助 用 户 访 问 电子 邮件 、Web 和 流 式 媒体 的 互联 网 技术 ， 它 为 用 户 提供 了 
无 线 的 宽带 互联 网 访问 。 同 时 ， 它 也 是 在 家 里 、 办 公 室 或 在 旅途 中 比较 快速 、 便 捷 的 上 网 途 
fe. WIFI 在 掌上 设备 上 应 用 越 来 越 广泛 ， 而 智能 手机 就 是 其 中 一 份子 。 与 早 前 应 用 于 手机 
上 的 蓝牙 技术 不 同 ，WIFI 具有 更 大 的 覆盖 范围 和 更 高 的 传输 速率 ， 因 此 WIFI 手机 成 为 了 目 
前 移动 通信 业界 的 时 尚 潮流 。 


332 


8.4.2 WIFI 实例 


第 8 章 ”网 络 编程 


Android SDK 提供 了 WIFI 开发 的 相关 API， 被 保存 在 android.net.wifi 和 android.net.wifi. 
p2p 包 下 。 借 助 于 Android SDK 提供 的 相关 开发 类 ， 可 以 方便 地 在 Android 系统 的 手机 上 开 


发 基于 WIFI 的 应 用 程序 。 


实例 WIFIDemo 演示 了 使 用 WIFI 进行 可 以 连接 设备 搜索 并 获取 相应 信息 的 过 程 ， 运 行 


效果 如 图 8.9 所 示 。 


wl BD © 下 午 223 


8.9 实例 WIFIDemo 运行 效果 
实例 WIFIDemo 中 所 使 用 的 布局 文件 main.xml 内 容 如 下 : 


<?xml version="1.0" encoding="utf-8"?> 


«ScrollView xmlns:android="http://schemas.android.com/apk/res/android" 
android: id="@+id/mScrollView" android:layout width-"fill parent" 
android:layout height-"wrap content" android:scrollbars-"vertical"» 


«LinearLayout 


xmlns:android-"http://schemas.android.com/apk/res/android" 


android:layout width-"fill parent" 
android:layout height-"fill parent" 
android:orientation-"vertical"» 


«LinearLayout 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android: orientation="horizontal"> 


<Button 
android: id="@+id/open_bt" 
android: layout_width="wrap content" 
android:layout height-"wrap content" 
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android:text-"7/JFwifi" /> 


<Button 
android: id="@+id/close_bt" 
android: layout_width="wrap content" 
android:layout height-"wrap content" 
android:text-"J wifi" /> 


«Button 
android: id="@+id/check_bt" 
android: layout_width="wrap content" 
android:layout height-"wrap content" 
android:text="f¢#Fwifi" /> 


«Button 
android: id="@+id/search_ bt" 
android: layout_width="wrap_ content" 
android:layout height-"wrap content" 
android:text-"77/f/jwifi" /> 
«/LinearLayout» 
«TextView 
android: id="@+id/text" 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:text-"null"/» 
«/LinearLayout» 
«/ScrollView» 


实例 WIFIDemo 中 的 AndroidManifest.xml 文件 代码 如 下 : 


<?xml version="1.0" encoding="utf-8"?> 

«manifest xmlns:android="http: //schemas.android.com/apk/res/android" 
package="sie.android.wifi" 
android: versionCode="1" 
android: versionName="1.0"> 


<uses-sdk android:minSdkVersion="10" /> 

<uses-permission 
android:name-"android.permission.CHANGE NETWORK STATE" /> 

«uses-permission android:name-"android.permission.CHANGE WIFI STATE" 
/> 

<uses-permission 
android:name="android.permission.ACCESS_NETWORK_STATE" /> 

«uses-permission android:name-"android.permission.ACCESS WIFI STATE" 
/> 

<application 

android:icon-"edrawable/ic launcher" 
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android: label="@string/app_name"> 
<activity 
android:name- "introduction.android.wifi.WifiDemoActivity" 
android:label-"estring/app name"» 
«intent-filter» 
«action android:name- "android.intent.action.MAIN" /» 


«category 
android:name-"android.intent.category.LAUNCHER" /» 
«/intent-filter» 
«/activity» 
«/application» 
«/manifest» 


实例 WIFIDemo 中 的 主 Activity 文件 WifiDemoActivity.java 代码 如 下 : 


package introduction.android.wifi; 


import java.util.List; 

import android.R.string; 

import android.app.Activity; 

import android.content.Context; 
import android.net.wifi.ScanResult; 
import android.net.wifi.WifiInfo; 
import android.net.wifi.WifiManager; 
import android.os.Bundle; 

import android.view. View; 

import android.view.View.OnClickListener; 
import android.widget .Button; 

import android.widget.ScrollView; 
import android.widget.TextView; 
import android.widget.Toast; 


public class WifiDemoActivity extends Activity { 
private Button open bt, close bt, check bt, search bt; 
private TextView textView; 
private WifiManager wifiManager; 
private WifiInfo wifiInfo; 
private ScrollView scrollView; 
private List WifiConfiguration; 
private ScanResult scanResult; 
private List<ScanResult>WifiList; 
private StringBuffer stringBuffer-new StringBuffer(); 


/** Called when the activity is first created. */ 


public void onCreate (Bundle savedInstanceState) { 
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super.onCreate (savedInstanceState) ; 
setContentView (R.layout.main) ; 


scrollView= (ScrollView) findViewById (R.id.mScrollView) ; 
open bt= (Button) findViewById (R.id.open bt) ; 

close bt- (Button) findViewById (R.id.close bt) ; 

check bt- (Button) findViewById (R.id.check bt) ; 

search bt- (Button) findViewById (R.id.search bt) ; 
textView- (TextView) findViewById (R.id.text) ; 


open bt.setOnClickListener (new open btListener()) ; 
close bt.setOnClickListener (new close btListener()) ; 
check bt.setOnClickListener (new check btListener()) ; 
Search bt.setOnClickListener (new search btListener()) ; 


} 


class search btListener implements OnClickListener { 
public void onClick (View v) { 
// TODO Auto-generated method stub 


wifiManager.startScan() ; 
WifiList=wifiManager.getScanResults() ; 
wifiInfo=wifiManager.getConnectionInfo() ; 


if (stringBuffer !-null) { 
stringBuffer=new StringBuffer () ; 


} 


stringBuffer-stringBuffer.append ("Wifi 4") .append (" 
") .append ("Wifi 地 址 ") .append (" ") .append ("Wifi 频率 ") .append (" 
") .append ("Wifi 信号 ") .append ("Wn") ; 
if (WifiList !-null) { 
for (int i-0; icWifiList.size(); i++) { 
scanResult=WifiList.get (i) ; 
stringBuffer-stringBuffer.append 
(scanResult.SSID) .append (" ") 


.append 
(scanResult.BSSID) .append (" ") 

.append 
(scanResult.frequency) .append (" ") 

-append 


(scanResult.level) .append ("Wn") ; 


textView.setText 
(stringBuffer.toString()) ; 


} 


stringBuffer=stringBuffer.append ("-------------- 
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ee ee E ") -append ("\n") ; 


textView.setText (stringBuffer.toString()) ; 
stringBuffer-stringBuffer.append ("当前 Wifi 


BSSID") .append (": ") .append (wifiInfo.getBSSID()) .append ("An") 
-append (" 当 前 Wifi—— 
HiddenSSID") .append (": ") .append (wifilnfo.getHiddenSSID()) .append 
(An) 
-append (" 当 前 Wifi 一 一 
IpAddress") .append (": ") .append (wifiInfo.getIpAddress()) .append 
(Ca?) 


.append ("当前 Wifi 一 一 
LinkSpeed") .append (": ") „append (wifiInfo.getLinkSpeed()) .append 
(*An*) 

-append (" 当 前 Wifi—— 


MacAddress") .append (": ") „append (wifiInfo.getMacAddress()) .append 
CENE) 

.append ("当前 Wifi— Network 
ID") .append (": ") „append (wifilnfo.getNetworkId()) .append ("Wn") 

.append ("当前 Wifi——RSSI") .append 
(qus ") „append (wifiInfo.getRssi()) .append ("Mn") 

.append ("当前 Wifi——SSID") .append 
(n: ") „append (wifilnfo.getSSID()) .append ("Mn") 

.append ("-------------------------- 
--------------------- ") .append ("\n") 


„append ("全 部 打印 出 关于 本 机 Wifi 信息 
") .append (": ") „append (wifiInfo.toString()) ; 


textView.setText (stringBuffer.toString()) ; 
} 
//stringBuffer=stringBuffer.append ("------------------- 
了 ") .append ("\n") ; 
//textView.setText () 


class check_btListener implements OnClickListener { 


public void onClick (View v) { 

// TODO Auto-generated method stub 

wifiManager= (WifiManager) WifiDemoActivity.this 
-getSystemService (Context.WIFI SERVICE) ; 

System.out.println ("wifi state --- 

>"+wifiManager.getWifiState()) ; 

Toast .makeText (WifiDemoActivity.this, 

"当前 网 卡 状态 为 : "+change () ， 
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Toast .LENGTH SHORT) 
-Show() ; 


} 


class close_btListener implements OnClickListener { 


public void onClick (View v) { 
// TODO Auto-generated method stub 
wifiManager= (WifiManager) WifiDemoActivity.this 
-getSystemService (Context.WIFI SERVICE) ; 
wifiManager.setWifiEnabled (false) ; 
System.out.println ("wifi state --- 
>"+wifiManager.getWifiState()) ; 
Toast .makeText (WifiDemoActivity.this, 
"当前 网 卡 状态 为 : "+change () ， 
Toast.LENGTH SHORT) 
.Show() ; 


} 


class open_btListener implements OnClickListener { 


public void onClick (View v) { 
// TODO Auto-generated method stub 
wifiManager= (WifiManager) WifiDemoActivity.this 
.getSystemService (Context.WIFI SERVICE) ; 
wifiManager.setWifiEnabled (true) ; 
System.out.println ("wifi state --- 
>"4+wifiManager.getWifiState()) ; 
Toast.makeText (WifiDemoActivity.this, 
"当前 网 卡 状态 为 : "+change () ， 
Toast.LENGTH SHORT) 
.Show() ; 


} 
} 


public String change() { 
String temp-null; 
switch (wifiManager.getWifiState()) { 
case 0: 
temp="Wifi 正在 关闭 ING"; 
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break; 

case 1: 
temp-"Wifi 已 经 关闭 "; 
break; 

case 2: 
temp-"Wifi 正在 打开 ING"; 
break; 

case 3: 
temp-"Wifi 已 经 打开 "7 
break; 

default: 

break; 
} 
return temp; 
} 
} 


8.4.3 WIFI Direct 

WIFI Direct， 意 为 通过 WIFI 直接 建立 连接 。2010 年 10 月 ，WIFI 联盟 发 布 WIFI Direct 
和 白皮书， 白皮书 中 介绍 了 关于 这 种 技术 的 基本 信息 、 特 点 和 功能 。WIFI Direct 标准 是 指 允 许 
无 线 网 络 中 的 设备 无 需 通过 无 线路 由 器 即 可 相互 连接 。 这 种 标准 允许 支持 WIFI 的 无 线 设备 
像 蓝 牙 那样 以 点 对 点 的 形式 互 连 ， 但 是 在 传输 速度 与 传输 距离 方面 都 比 蓝牙 有 大 幅 提 升 。 

WIFI Direct 设备 是 支持 对 等 连接 的 设备 ， 这 种 设备 既 支 持 基础 设施 网 络 ， 也 支持 POP 
(点 对 点 ，Peer To Peer) 连接 。 

Android 4.0 提供 了 WIFI Direct 用 于 WIFI 的 直接 连接 。 借 助 于 WIFI Direct API, “HF 
WIFI 功能 的 Android 4.0 系统 的 手机 可 以 直接 通过 WIFI 连接 ， 而 不 需要 经 过 接 入 点 (Access 
Point) 。 

WIFI Direct 提供 WifiP2pManager 类 ， 其 功能 主要 分 为 以 下 三 部 分 : 


* WifiP2pManager 类 提供 相关 API 用 于 发 现 可 连接 的 点 ， 并 进行 请 求 和 建立 连接 。 

e 每 个 WifiP2pManager 的 方法 都 要 求 传 入 对 应 的 监听 器 ， 用 于 监听 对 该 方法 是 否 成 功 

e 当 检测 到 特定 事件 ， 如 可 连接 的 点 减少 或 者 发 现 了 新 的 可 连接 的 点 ，WIFI Direct 框 
架 会 通过 Intent 通 知 用 户 。 


一 般 情况 下 ， 这 三 部 分 功能 是 共同 使 用 的 。 例 如 ， 可 以 通过 WifiP2pManager. 
ActionListener 调用 discoverPeers()， 以 便当 建立 连接 时 ， 可 以 通过 ActionListener.onSuccess() 
和 ActionListener.onFailure() 方 法 获得 相应 结果 的 通知 。 当 discoverPeers() 方 法 探测 到 发 现 列 
表 中 的 点 发 生 改 变 时 ， 一 个 包含 WIFI P2P PEERS CHANGED ACTION 信息 的 Intent 会 被 
广播 。WifiP2pManager 提供 的 方法 如 表 8.5 所 示 。 
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表 8.5 WifiP2pManager 的 方法 


方法 名 描述 

initiatize() 为 应 用 程序 注册 WIFI 框架 。 该 方法 必须 在 任何 其 他 WIFI Direct 方法 被 调用 前 
调用 。 

connect() 与 具有 指定 配置 的 WIFI 设备 建立 点 对 点 连接 。 

cancelConnect() 断 开 连接 

requestConnectInfo() 获取 设备 的 连接 信息 

createGroup() 以 当前 设备 为 拥有 者 创建 一 个 点 对 点 组 

removeGroup() 删除 当前 的 点 对 点 组 

requestGroupInfo() 获取 点 对 点 组 的 信息 

discoverPeers() 初始 化 发 现 对 等 点 设备 服务 

requestPeers() 获取 当前 已 发 现 的 对 等 点 设备 列表 


WifiP2pManager 支持 的 监听 器 如 表 8.6 所 示 。 


表 8.6 WifiP2pManager 支持 的 监听 器 


监听 器 接口 
WifiP2pManager.ActionListener 


WifiP2pManager.ChannelListener 
WifiP2pManager.ConnectionInfoListener 


WifiP2pManager.GroupInfoListener 


WifiP2pManager.PeerListListener 


lconnect(), cancelConnect(), createGroup(), removeGroup(), 
and discoverPeers() 


WifiP2pManager 支持 的 Intent 如 表 8.7 所 示 。 


表 8.7 WiffP2pManager 支 持 的 Intent 


Intent 


WIFI P2P CONNECTION CHANGED ACTION ”| 当 WIFI 设备 的 连接 状态 改变 时 广播 
当 discoverPeers() 方 法 被 调用 时 广播 。 通 过 该 Intent 可 
WIFI P2P PEERS CHANGED ACTION 以 获取 到 最 新 的 对 等 点 设备 的 列表 。 


WIFI P2P STATE CHANGED ACTION 


当 WIFI Direct 功能 在 设备 上 被 打开 或 者 关闭 时 广播 


WIFI P2P THIS DEVICE CHANGED ACTION 


当 WE 设备 的 具体 信息 改变 时 广播 ， 例 如 设备 的 名 字 
改变 时 。 


340 


第 8 章 ”网 络 编程 


8.44 创建 WIFI Direct 应 用 程序 的 步骤 


创建 一 个 WIFI Direct 应 用 程序 ， 包 括 发 现 连接 点 、 请 求 连接 、 建 立 连接 、 发 送 数据 ， 
以 及 建立 对 该 应 用 程序 广播 的 Intent 进行 接收 的 BroadcastReceiver， 需 要 经 过 以 下 步骤 。 


人 OO) 创建 BroadcastReceiver， 需 要 注意 的 是 要 在 BroadcastReceiver 的 构造 方法 中 传 入 
WifiP2pManager 、 WifiP2pManager.Channel 以 及 注册 该 BroadcastReceiver 的 
Activity 的 对 象 ， 以 便 在 BroadcastReceiver 中 访问 WIFI 硬件 设备 并 对 Activity 进行 
更 新 。 


创建 BroadcastReceiver 的 代码 如 下 : 


public class WiFiDirectBroadcastReceiver extends BroadcastReceiver { 
private WifiP2pManager manager; 
private Channel channel; 
private MyWiFiActivity activity; 


public WiFiDirectBroadcastReceiver (WifiP2pManager manager, Channel 
channel, 
MyWifiActivity activity) { 
super () ; 
this.manager=manager; 
this.channel-channel; 
this.activity-activity; 


} 


GOverride 
public void onReceive (Context context, Intent intent) { 
String action-intent.getAction(); 


if (WifiP2pManager.WIFI P2P STATE CHANGED ACTION.equals 
(action) ) { 
// 检测 WIFI 功能 是 否 被 打开 
) else if (WifiP2pManager.WIFI P2P PEERS CHANGED ACTION.equals 
(action) ) { 
// 获得 当前 可 用 连接 点 的 列表 
} else if 
(WifiP2pManager.WIFI P2P CONNECTION CHANGED ACTION.equals (action) ) { 
// 建立 或 者 断 开 连接 
} else if 
(WifiP2pManager.WIFI P2P THIS DEVICE CHANGED ACTION.equals (action) ) { 


// 前 设备 的 WIFI 状态 发 生变 化 
} 
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CXX30 初始 化 操作 。 
(1) 修改 AndroidManifest.xml 文件 ， 指 定 支 持 WIFI Direct 的 Android SDK 的 最 小 版 本 
并 增加 使 用 WIFI Direct 的 相应 权限 。 代 码 如 下 : 


<uses-sdk android:minSdkVersion="14" /> 

<uses-permission android:name="android.permission.ACCESS WIFI_STATE" /> 

«uses-permission android:name-"android.permission.CHANGE WIFI STATE" /> 

«uses-permission android:name-"android.permission.CHANGE NETWORK STATE" 
"E 

«uses-permission android:name-"android.permission.INTERNET" /> 

«uses-permission android:name-"android.permission.ACCESS NETWORK STATE" 


/> 


(2) 确认 当前 设备 是 否 支 持 并 且 打 开 了 WIFI Direct 功能 。 相 关 代 码 应 该 被 放 在 
BroadcastReceiver 的 onReceive0) 方 法 中 。 实 例 代码 如 下 : 


public void onReceive (Context context, Intent intent) { 
String action-intent.getAction(); 
if (WifiP2pManager.WIFI P2P STATE CHANGED ACTION.equals (action) ) { 
int state-intent.getIntExtra (WifiP2pManager.EXTRA WIFI STATE, 
a) 5 
if (state--WifiP2pManager.WIFI P2P STATE ENABLED) { 
// Wifi Direct is enabled 
} else { 
// Wi-Fi Direct is not enabled 
} 


(3) 在 Activity 的 onCreate 77 i: 8] £& WifiP2pManager 和 Channel 对 象 ， 并 创建 
BroadcastReceiver 对 象 。 


WifiP2pManager mManager; 

Channel mChannel; 

BroadcastReceiver mReceiver; 

@Override 

protected void onCreate (Bundle savedInstanceState) { 

mManager= (WifiP2pManager) getSystemService 

(Context .WIFI_P2P_ SERVICE) ; 
mChannel=mManager.initialize (this, getMainLooper(), null) ; 
mReceiver=new WiFiDirectBroadcastReceiver (manager, channel, 

this) ; 
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(4) 创建 BroadcastReceiver 要 使 用 的 IntentFilter 对 象 。 


IntentFilter mIntentFilter; 
GOverride 
protected void onCreate (Bundle savedInstanceState) { 
mIntentFilter-new IntentFilter(); 
mIntentFilter.addAction 
(WifiP2pManager.WIFI P2P STATE CHANGED ACTION) ; 
mIntentFilter.addAction 
(WifiP2pManager.WIFI P2P PEERS CHANGED ACTION) ; 
mIntentFilter.addAction 
(WifiP2pManager.WIFI P2P CONNECTION CHANGED ACTION) ; 
mIntentFilter.addAction 
(WifiP2pManager.WIFI P2P THIS DEVICE CHANGED ACTION) ; 


) 


(5) 在 Activity 的 onResume() 方 法 中 注册 BroadcastReceiver 对 象 ， 在 onPause() 方 法 中 注 


GOverride 
protected void onResume () { 

super .onResume () ; 

registerReceiver (mReceiver, mIntentFilter) ; 
} 
/* unregister the broadcast receiver */ 
GOverride 
protected void onPause() { 

super.onPause () ; 

unregisterReceiver (mReceiver) ; 


} 
€XX03 使 用 WifiP2pManager.discoverPeers() 方 法 获取 可 以 连接 点 列表 。 示 例 代码 如 下 : 


manager.discoverPeers (channel, new WifiP2pManager .ActionListener () { 
GOverride 
public void onSuccess() { 


} 


GOverride 
public void onFailure (int reasonCode) { 
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} 
D: 


若 成 功 搜寻 到 可 以 的 连接 点 ， 则 WIFI Direct 系统 框架 会 广播 一 个 带 有 WIFI P2P_ 
PEERS CHANGED ACTION 信息 的 Intent, iZ Intent 会 被 之 前 定义 的 BoradcastReceiver 接 
收 ， 并 获得 可 以 连接 点 的 列表 。 示 例 代 码 如 下 : 


PeerListListener myPeerListListener; 


if (WifiP2pManager.WIFI P2P PEERS CHANGED ACTION.equals (action) ) { 
if (manager !-null) { 
manager.requestPeers (channel, myPeerListListener) ; 


} 


€o 通过 WifiP2pManagerconnect() 方 法 可 以 与 列表 中 的 某 个 连接 点 设备 建立 连接 ， 该 
方法 通过 WifiP2pConfig 对 象 获得 连接 设备 的 相关 信息 。 示 例 代 码 如 下 : 
WifiP2pDevice device; 
WifiP2pConfig config=new WifiP2pConfig() ; 


config.deviceAddress-device.deviceAddress; 
manager.connect (channel, config, new ActionListener () { 


GOverride 

public void onSuccess()( 
//success logic 

} 


GOverride 

public void onFailure (int reason) { 
//failure logic 

} 


Pe 


GES 连接 建立 后 ， 就 可 以 来 两 个 设备 直接 通过 Socket 进行 数据 传输 。 其 传输 过 程 与 之 
前 讲解 的 Socket 通信 完全 相同 ， 基 本 步骤 如 下 : 


COD 在 其 中 一 个 设备 上 建立 ServerSocket 对 象 ， 监 昕 特定 端口 ， 并 堵塞 应 用 程序 直到 有 
连接 请 求 。 

(2) 在 另外 一 个 设备 上 建立 Socket 对 象 ， 通 过 IP 地 址 和 端口 向 ServerSocket 发 出 连接 
请 求 。 

(3) ServerSocket 监听 到 连接 请 求 后 ， 调 用 accept0 方 法 建立 连接 。 

(4) 连接 建立 后 ，Socket 对 象 可 以 通过 字 节 流 在 两 个 设备 直接 进行 数据 传递 。 

下 列 示 例 代码 演示 了 通过 ServerSocket 和 Socket 在 客户 端 和 服务 器 直接 传递 卫 G 图 像 的 
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服务 器 代码 如 下 : 


public static class FileServerAsyncTask extends AsyncTask { 


private Context context; 
private TextView statusText; 


public FileServerAsyncTask (Context context, View statusText) { 
this.context=context; 
this.statusText= (TextView) statusText; 


GOverride 
protected String doInBackground (Void... params) { 


try { 


// 创 建 ServerSocket 对 象 ， 监 听 8888 端口 ， 等 待 客 户 连接 
ServerSocket serverSocket=new ServerSocket (8888) ; 
Socket client=serverSocket.accept () ; 


// 建 立 连 接 成 功 ， 开 始 传输 数据 
final File f=new File 
(Environment .getExternalStorageDirectory()+"/" 
+context . get PackageName () +"/wifip2pshared- 
"4+System.currentTimeMillis() 
+".jpg") ; 


File dirs-new File (f.getParent()) ; 
if (!dirs.exists()) 
dirs.mkdirs(); 
f.createNewFile(); 
InputStream inputstream-client.getInputStream(); 
copyFile (inputstream, new FileOutputStream (f) ) ; 
serverSocket.close(); 
return f.getAbsolutePath(); 
) catch (IOException e) { 
Log.e (WiFiDirectActivity.TAG, e.getMessage()) ; 
return null; 


} 


// 启 动用 于 显示 图 像 的 Activity 
Goverride 
protected void onPostExecute (String result) { 
if (result !-null) { 
statusText.setText ("File copied - "+result) ; 
Intent intent-new Intent(); 
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intent.setAction (android.content.Intent.ACTION VIEW) ; 
intent.setDataAndType (Uri.parse ("file://"+result) , 


"image/*") i 
context.startActivity (intent) ; 
} 
} 
} 
客户 端的 相关 代码 如 下 : 


Context context=this.getApplicationContext () ; 
String host; 
int port; 
int len; 
Socket socket=new Socket () ; 
byte buf[]-new byte [1024]; 
try { 
// 创 建 Socket 对象， 并 请 求 连接 
Socket.bind (null) ; 
Socket.connect ( (new InetSocketAddress (host, port) ) , 500) ; 


// 连 接 建 立成 功 ， 开 始 传输 数据 

OutputStream outputStream-socket.getOutputStream(); 
ContentResolver cr=context .getContentResolver () ; 
InputStream inputStream-null; 
inputStream=cr.openInputStream (Uri.parse 

("path/to/picture.jpg") ) ; 
while ( (len=inputStream.read (buf) ) !=-1) { 
outputStream.write (buf, 0, len) ; 

} 
outputStream.close(); 
inputStream.close(); 

) catch (FileNotFoundException e) { 
//catch logic 

) catch (IOException e) { 
//catch logic 


} 


// 关 闭 连接 
finally { 
if (socket !=null) { 
if (socket .isConnected()) { 
try { 
socket .close() ; 
} catch (IOException e) { 
//catch logic 
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8.4.5 ”WIFI Direct 编程 实例 


实例 WIFIDirectDemo 改编 自 Android SDK 提供 的 实例 ， 演 示 了 通过 WIFI 搜寻 连接 点 ， 
建立 连接 ， 并 进行 数据 传输 的 过 程 。 

该 实例 包含 五 个 类 : 

* WIFIDirectDemoActivity: 用 于 注册 BroadcastReceiver， 处 理 UI， 并 管理 连接 点 的 生 
命 周 期 。 

* WiFiDirectBroadcastReceiver: 用 于 接收 与 WIFIDirect 功能 相关 的 Intent. 

© DeviceListFragment: 用 于 显示 可 以 连接 点 列表 及 其 状态 。 

© FileTransferService: 通过 TCP 协议 在 客户 端 与 服务 器 之 间 进 行文 件 传输 的 
JIntentService。 


* IntentService 是 Sevice 的 子 类 ， 用 于 处 理 异 步 请 求 。 
该 实例 运行 效果 如 图 8.10 所 示 。 


Wi-Fi Direct 


Wi-Fi Direct connection setup request 
from 42:fc:89:a8:8f-f. Click OK to 


图 8.10 ”实例 WIFIDirectDemo 运行 效果 
WIFIDirectDemo 的 AndroidManifestxml 文件 内 容 如 下 : 
<?xml version-"1.0" encoding-"utf-8"?» 


«manifest xmlns:android-"http://schemas.android.com/apk/res/android" 
package-"introduction.android.wifidirectdemo" 
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android:versionCode-"1" android:versionName-"1.0"» 


«uses-sdk android:minSdkVersion-"14" /> 

«uses-permission android:name-"android.permission.ACCESS WIFI STATE" 
/> 

«uses-permission android:name="android.permission.CHANGE WIFI STATE" 
/> 

<uses-permission 
android:name-"android.permission.CHANGE NETWORK STATE" /> 

«uses-permission android:name-"android.permission.INTERNET" /» 

«uses-permission 
android:name-"android.permission.ACCESS NETWORK STATE" /» 

«uses-permission android:name-"android.permission.READ PHONE STATE" 
/> 

<uses-permission 
android:name-"android.permission.WRITE EXTERNAL STORAGE" /> 


<!-- Market filtering --> 
«uses-feature android:name- "android.hardware.wifi.direct" 
android: required="true"/> 


<application 
android: icon="@drawable/ic_launcher" 
android: label="@string/app_ name" 
android: theme="@android: style/Theme.Holo"> 
<activity 
android:name=".WIFIDirectDemoActivity" 
android: label="@string/app_ name" 
android: launchMode="singleTask"> 
<intent-filter> 
<action 
android:name="android.intent.action.MAIN" /> 
<category 
android:name="android.intent.category.LAUNCHER" /> 
</intent-filter> 
</activity> 


<!-- Used for transferring files after a successful connection 


<service android:enabled="true" 
android:name=".FileTransferService" /> 


</application> 
</manifest> 


WIFIDirectDemoActivity.java 代码 如 下 : 
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package introduction.android.wifidirectdemo; 


import 


introduction.android.wifidirectdemo.DeviceListFragment .DeviceActionListene 


Ei 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 


public 


android.app.Activity; 
android.content.BroadcastReceiver; 
android.content.Context; 

android.content.Intent; 
android.content.IntentFilter; 
android.net.wifi.p2p.WifiP2pConfig; 
android.net.wifi.p2p.WifiP2pDevice; 
android.net.wifi.p2p.WifiP2pManager; 
android.net.wifi.p2p.WifiP2pManager.ActionListener; 
android.net.wifi.p2p.WifiP2pManager.Channel; 
android.net.wifi.p2p.WifiP2pManager.ChannelListener; 
android.os.Bundle; 

android.provider.Settings; 

android.util.Log; 

android.view.Menu; 

android.view.MenuInflater; 

android.view.MenuItem; 

android.view.View; 

android.widget.Toast; 


class WIFIDirectDemoActivity extends Activity implements 


ChannelListener, DeviceActionListener ( 


public static final String TAG-"wifidirectdemo"; 
private WifiP2pManager manager; 

private boolean isWifiP2pEnabled-false; 

private boolean retryChannel-false; 


private final IntentFilter intentFilter-new IntentFilter(); 
private Channel channel; 
private BroadcastReceiver receiver-null; 


public void setIsWifiP2pEnabled (boolean isWifiP2pEnabled) { 


this.isWifiP2pEnabled-isWifiP2pEnabled; 


public void onCreate (Bundle savedInstanceState) { 


super.onCreate (savedInstanceState) ; 
setContentView (R.layout.main) ; 
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// add necessary intent values to be matched. 


intentFilter.addAction 
(WifiP2pManager.WIFI P2P STATE CHANGED ACTION) ; 
intentFilter.addAction 
(WifiP2pManager.WIFI P2P PEERS CHANGED ACTION) ; 
intentFilter.addAction 
(WifiP2pManager.WIFI P2P CONNECTION CHANGED ACTION) ; 
intentFilter.addAction 
(WifiP2pManager.WIFI P2P THIS DEVICE CHANGED ACTION) ; 


manager- (WifiP2pManager) getSystemService 
(Context.WIFI P2P SERVICE) ; 
channel-manager.initialize (this, getMainLooper(), null) ; 


/** register the BroadcastReceiver with the intent values to be 
matched */ 


public void onResume() { 


super.onResume () ; 
receiver-new WiFiDirectBroadcastReceiver (manager, channel, 


this) ; 
registerReceiver (receiver, intentFilter) ; 


public void onPause() { 
super.onPause(); 
unregisterReceiver (receiver) ; 


/** 
* Remove all peers and clear all fields. This is called on 
* BroadcastReceiver receiving a state change event. 
ey 
public void resetData ()[ 
DeviceListFragment fragmentList- (DeviceListFragment) 


getFragmentManager () 
.findFragmentById (R.id.frag list) ; 
DeviceDetailFragment1 fragmentDetails- (DeviceDetailFragment1) 


getFragmentManager () 
.findFragmentById (R.id.frag detail) ; 
if (fragmentList !=null) { 
fragmentList.clearPeers(); 


} 


if (fragmentDetails !=null) { 
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fragmentDetails.resetViews(); 


public boolean onCreateOptionsMenu (Menu menu) { 
MenuInflater inflater=getMenuInflater () ; 
inflater.inflate (R.menu.action_items, menu) ; 
return true; 


public boolean onOptionsItemSelected (MenuItem item) { 
switch (item.getItemId()) { 
case R.id.atn_direct_enable: 
if (manager !=null && channel !=null) { 
startActivity (new Intent 
(Settings.ACTION WIRELESS SETTINGS) ) ; 


} else { 
Log.e (TAG, "Channel or manager is null") ; 
} 


return true; 


case R.id.atn_direct_discover: 
if (!isWifiP2pEnabled) { 
Toast .makeText (WIFIDirectDemoActivity.this, 
R.string.p2p off warning, 
Toast.LENGTH SHORT) .show(); 
return true; 


} 


final DeviceListFragment fragment= 
(DeviceListFragment) getFragmentManager () 
.findFragmentById (R.id.frag list) ; 


fragment .onInitiateDiscovery () ; 
manager.discoverPeers (channel, new 


WifiP2pManager .ActionListener () { 


public void onSuccess() { 
Toast .makeText (WIFIDirectDemoActivity.this, 


"Discovery Initiated", 
Toast.LENGTH SHORT) .show() ; 


public void onFailure (int reasonCode) { 
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Toast .makeText (WIFIDirectDemoActivity.this, 


"Discovery Failed : "+reasonCode, 
Toast.LENGTH SHORT) .show() ; 
} 
1297 
return true; 
default: 
return super.onOptionsItemSelected (item) ; 


public void showDetails (WifiP2pDevice device) { 
DeviceDetailFragmenti fragment- (DeviceDetailFragment1) 
getFragmentManager () 
.findFragmentById (R.id.frag detail) ; 
fragment.showDetails (device) ; 


public void connect (WifiP2pConfig config) { 
manager.connect (channel, config, new ActionListener () { 
public void onsuccess () { 
// WiFiDirectBroadcastReceiver will notify us. Ignore 
for now. 
} 
public void onFailure (int reason) { 
Toast .makeText (WIFIDirectDemoActivity.this, "Connect 
failed. Retry.", 
Toast .LENGTH_SHORT) .show() ; 


Di 


public void disconnect () { 
final DeviceDetailFragment1 fragment= (DeviceDetailFragment1) 


get FragmentManager () 
.findFragmentById (R.id.frag detail) ; 


fragment .resetViews () ; 
Manager .removeGroup (channel, new ActionListener () { 


public void onFailure (int reasonCode) { 
Log.d (TAG, "Disconnect failed. Reason :"+reasonCode) ; 
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} 


public void onSuccess() { 
fragment .getView() .setVisibility (View.GONE) ; 


Dar 


public void onChannelDisconnected() { 
if (manager !=null && !retryChannel) { 
Toast.makeText (this, "Channel lost. Trying again", 
Toast .LENGTH LONG) .show() ; 
resetData(); 
retryChannel-true; 
manager.initialize (this, getMainLooper(), this) ; 
) eise ( 
Toast.makeText (this, 
"Severe! Channel is probably lost premanently. Try 
Disable/Re-Enable P2P.", 
Toast.LENGTH LONG) .show(); 
} 


public void cancelDisconnect () { 


if (manager !=null) { 
final DeviceListFragment fragment= (DeviceListFragment ) 
get FragmentManager () 
.findFragmentById (R.id.frag list) ; 
if (fragment.getDevice()--null 
fragment.getDevice(). m UE iP2pDevice.CONNECTED) { 
disconnect(); 
) eise if 
(fragment.getDevice().status--WifiP2pDevice.AVAILABLE 


fragment.getDevice().status--WifiP2pDevice.INVITED) { 


manager.cancelConnect (channel, new ActionListener () { 


public void onSuccess() { 
Toast .makeText (WIFIDirectDemoActivity.this, 
"Aborting connection", 
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Toast .LENGTH SHORT) .show() ; 


public void onFailure (int reasonCode) { 
Toast .makeText (WIFIDirectDemoActivity.this, 
"Connect abort request failed. Reason 


Code: "+reasonCode, 


Toast .LENGTH SHORT) .show(); 


WiFiDirectBroadcastReceiver.java 代码 如 下 : 


package introduction.android.wifidirectdemo; 


import 
import 
import 
import 
import 
import 
import 
import 
import 
public 


android.content .BroadcastReceiver; 

android.content.Context; 

android.content.Intent; 

android.net.NetworkInfo; 

android.net.wifi.p2p.WifiP2pDevice; 
android.net.wifi.p2p.WifiP2pManager; 
android.net.wifi.p2p.WifiP2pManager.Channel; 
android.net.wifi.p2p.WifiP2pManager.PeerListListener; 
android.util.Log; 

class WiFiDirectBroadcastReceiver extends BroadcastReceiver { 


private WifiP2pManager manager; 

private Channel channel; 

private WIFIDirectDemoActivity activity; 
public WiFiDirectBroadcastReceiver (WifiP2pManager manager, Channel 


channel, 
WIFIDirectDemoActivity wifiDirectDemoActivity) { 

super () ; 
this.manager-manager; 
this.channel-channel; 
this.activity-wifiDirectDemoActivity; 

} 

GOverride 


public void onReceive (Context context, Intent intent) d 


(action) ) 
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// UI update to indicate wifi p2p status. 
int state=intent .getIntExtra 
(WifiP2pManager.EXTRA WIFI STATE, -1) ; 

if (state==WifiP2pManager.WIFI_P2P_STATE ENABLED) { 
// Wifi Direct mode is enabled 
activity.setIsWifiP2pEnabled (true) ; 

} else { 
activity.setIsWifiP2pEnabled (false) ; 
activity.resetData() ; 


} 


Log.d (WIFIDirectDemoActivity.TAG, "P2P state changed - 


"+state) ; 
} else if (WifiP2pManager.WIFI P2P PEERS CHANGED ACTION.equals 


(action) ) { 
// request available peers from the wifi p2p manager. This 


// asynchronous call and the calling activity is notified 
with a 
// callback on PeerListListener.onPeersAvailable() 
if (manager !-null) { 
manager.requestPeers (channel, (PeerListListener) 


activity.getFragmentManager () 
.findFragmentById (R.id.frag list) ) ; 


} 
Log.d (WIFIDirectDemoActivity.TAG, "P2P peers changed") ; 
} else if 


(WifiP2pManager.WIFI P2P CONNECTION CHANGED ACTION.equals (action) ) { 


if (manager--null) { 


return; 
} 
NetworkInfo networkInfo- (NetworkInfo) intent 
.getParcelableExtra 


(WifiP2pManager.EXTRA NETWORK INFO) ; 


if (networkInfo.isConnected()) ( 

// we are connected with the other device, request 
connection 

// info to find group owner IP 

DeviceDetailFragment1 fragment- 
(DeviceDetailFragment1) activity 

.getFragmentManager () . findFragmentById 

(R.id.frag detail) ; 
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manager.requestConnectionInfo (channel, fragment) ; 
} else { 
// It's a disconnect 
activity.resetData() ; 
} 
} else if 
(WifiP2pManager.WIFI P2P THIS DEVICE CHANGED ACTION.equals (action) ) { 
DeviceListFragment fragment- (DeviceListFragment) 
activity.getFragmentManager () 
.findFragmentById (R.id.frag list) ; 
fragment .updateThisDevice ( (WifiP2pDevice) 
intent.getParcelableExtra ( 
WifiP2pManager.EXTRA WIFI P2P DEVICE) ) ; 


DeviceListFragment.java 代码 如 下 : 


package introduction.android.wifidirectdemo; 
import android.app.ListFragment ; 

import android.app.ProgressDialog; 

import android.content.Context; 

import android.content .DialogInterface; 

import android.net.wifi.p2p.WifiP2pConfig; 
import android.net.wifi.p2p.WifiP2pDevice; 
import android.net.wifi.p2p.WifiP2pDeviceList; 
import android.net.wifi.p2p.WifiP2pManager.PeerListListener; 
import android.os.Bundle; 

import android.util.Log; 

import android.view.LayoutInflater; 

import android.view. View; 

import android.view.ViewGroup; 

import android.widget .ArrayAdapter; 

import android.widget.ListView; 

import android.widget .TextView; 


import java.util.ArrayList; 

import java.util.List; 

public class DeviceListFragment extends ListFragment implements 
PeerListListener { 


private List<WifiP2pDevice>peers=new ArrayList<WifiP2pDevice>() ; 
ProgressDialog progressDialog-null; 

View mContentView-null; 

private WifiP2pDevice device; 
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@Override 
public void onActivityCreated (Bundle savedInstanceState) { 
super.onActivityCreated (savedInstanceState) ; 
this.setListAdapter (new WiFiPeerListAdapter (getActivity(), 
R.layout.row devices, peers) ) ; 


GOverride 
public View onCreateView (LayoutInflater inflater, ViewGroup 


container, Bundle savedInstanceState) { 
mContentView=inflater.inflate (R.layout.device list, null) ; 
return mContentView; 


/** 

* @return this device 

E 

public WifiP2pDevice getDevice()[ 
return device; 


) 


private static String getDeviceStatus (int deviceStatus) { 
Log.d (WIFIDirectDemoActivity.TAG, "Peer 
Status :"+deviceStatus) ; 
switch (deviceStatus) { 
case WifiP2pDevice.AVAILABLE: 
return "Available"; 
case WifiP2pDevice. INVITED: 
return "Invited"; 
case WifiP2pDevice.CONNECTED: 
return "Connected"; 
case WifiP2pDevice. FAILED: 
return "Failed"; 
case WifiP2pDevice.UNAVAILABLE: 
return "Unavailable"; 
default: 
return "Unknown"; 


/** 


* Initiate a connection with the peer. 
E 
@Override 
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public void onListItemClick (ListView 1, View v, int position, long 


id) { 
WifiP2pDevice device= (WifiP2pDevice) getListAdapter() .getItem 

(position) ; 

( (DeviceActionListener) getActivity()) .showDetails (device) ; 

) 

/** 

* Array adapter for ListFragment that maintains WifiP2pDevice 
list. 


m 
private class WiFiPeerListAdapter extends 
ArrayAdapter<WifiP2pDevice>{ 


private List<WifiP2pDevice>items; 
public WiFiPeerListAdapter (Context context, int 
textViewResourceld, 
List<WifiP2pDevice>objects) { 
super (context, textViewResourceId, objects) ; 
items=objects; 


GOverride 
public View getView (int position, View convertView, ViewGroup 
parent) ( 
View v-convertView; 
if (v--null) { 
LayoutInflater vi- (LayoutInflater) 
getActivity().getSystemService ( 
Context.LAYOUT INFLATER SERVICE) ; 
v-vi.inflate (R.layout.row devices, null) ; 
} 
WifiP2pDevice device=items.get (position) ; 
if (device !=null) { 
TextView top= (TextView) v.findViewById 
(R.id.device_name) ; 
TextView bottom- (TextView) v.findViewById 
(R.id.device details) ; 
if (top !=null) { 
top.setText (device.deviceName) ; 
} 
if (bottom !-null) { 
bottom.setText (getDeviceStatus (device.status) ) ; 
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return v; 


} 

} 

public void updateThisDevice (WifiP2pDevice device) { 
this.device=device; 
TextView view- (TextView) mContentView.findViewById 

(R.id.my name) ; 

view.setText (device.deviceName) ; 
view- (TextView) mContentView.findViewById (R.id.my status) ; 
view.setText (getDeviceStatus (device.status) ) ; 


} 


public void onPeersAvailable (WifiP2pDeviceList peerList) { 
if (progressDialog !=null && progressDialog.isShowing()) { 
progressDialog.dismiss(); 


} 


peers.clear(); 
peers.addAll (peerList.getDeviceList()) ; 
( (WiFiPeerListAdapter) getListAdapter()) .notifyDataSetChanged(); 


if (peers.size()--0) { 
Log.d (WIFIDirectDemoActivity.TAG, "No devices found") ; 
return; 

} 


} 


public void clearPeers()[ 
peers.clear(); 
( (WiFiPeerListAdapter) getListAdapter()) .notifyDataSetChanged(); 


} 
public void onInitiateDiscovery () { 
if (progressDialog !=null && progressDialog.isShowing()) { 


progressDialog.dismiss () ; 


} 


progressDialog=ProgressDialog.show (getActivity(), "Press back 


to cancel", "finding peers", true, 
true, new DialogInterface.OnCancelListener () { 


public void onCancel (DialogInterface dialog) { 


} 
ID) B 
} 


public interface DeviceActionListener { 


void showDetails (WifiP2pDevice device) ; 
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void cancelDisconnect () ; 
void connect (WifiP2pConfig config) ; 


void disconnect () ; 


FileTransferService.java 代码 如 下 : 


package introduction.android.wifidirectdemo; 


import android.app.IntentService; 
import android.content .ContentResolver; 
import android.content.Context; 

import android.content.Intent; 

import android.net.Uri; 

import android.util.Log; 


import java.io.FileNotFoundException; 

import java.io. IOException; 

import java.io.InputStream; 

import java.io.OutputStream; 

import java.net.InetSocketAddress; 

import java.net.Socket; 

public class FileTransferService extends IntentService { 


private static final int SOCKET_TIMEOUT=5000; 
public static final String 
ACTION SEND FILE-"com.example.android.wifidirect.SEND FILE"; 
public static final String EXTRAS FILE PATH-"file url"; 
public static final String EXTRAS GROUP OWNER ADDRESS-"go host"; 
public static final String EXTRAS GROUP OWNER PORT-"go port"; 


public FileTransferService (String name) { 
super (name) ; 


} 


public FileTransferService() { 
super ("FileTransferService") ; 


} 


@Override 
protected void onHandleIntent (Intent intent) { 


Context context-getApplicationContext () ; 
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if (intent.getAction().equals (ACTION SEND FILE) ) f 

String fileUri-intent.getExtras().getString 
(EXTRAS FILE PATH) ; 

String host-intent.getExtras().getString 
(EXTRAS GROUP OWNER ADDRESS) ; 

Socket socket-new Socket(); 

int port-intent.getExtras().getInt 
(EXTRAS GROUP OWNER PORT) ; 


try 
ee (WIFIDirectDemoActivity.TAG, "Opening client 
socket - ") ; 
socket .bind (null) ; 
socket .connect ( (new InetSocketAddress (host, port) ) , 
SOCKET TIMEOUT) ; 


Log.d (WIFIDirectDemoActivity.TAG, "Client socket - 
"+socket.isConnected()) ; 

OutputStream stream=socket .getOutputStream() ; 
ContentResolver cr-context.getContentResolver(); 
InputStream is-null; 
try { 

is=cr.openInputStream (Uri.parse (fileUri) ) ; 
} catch (FileNotFoundException e) { 

Log.d (WIFIDirectDemoActivity.TAG, e.toString()) ; 
} 


DeviceDetailFragment1.copyFile (is, stream) ; 
Log.d (WIFIDirectDemoActivity.TAG, "Client: Data 
written") ; 
) catch (IOException e) { 
Log.e (WIFIDirectDemoActivity.TAG, e.getMessage()) ; 
) finally { 
if (socket !-null) { 
if (socket.isConnected()) { 
try { 
socket .close() ; 
) catch (IOException e) { 
// Give up 
e.printStackTrace () ; 
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8.5.1 NFC 简介 


NFC (Near Field Communication) ， 也 叫 近 场 通信 技术 ， 是 基于 Android 系统 的 设备 最 
有 特色 的 技术 之 一 。NFC 是 一 种 近 距 离 的 无 线 通信 技术 ， 通 常 的 通信 距离 是 4 厘米 或 更 短 。 
NEC 的 工作 频率 是 13.56M Hz， 传 输 速率 是 106kbit/s 到 848kbits。 通 过 NFC 技术 ， 可 以 使 
Android 设备 与 NFC Tag 之 间或 者 其 他 Android 设备 之 间 传 输 小 数据 量 的 数据 。 

NFC Tag 分 很 多 种 ， 其 中 简单 的 只 提供 读 写 段 ， 有 的 只 能 读 ， 不 能 写 ; 复杂 的 Tag 可 以 
支持 一 些 数学 运算 ， 通 过 加 密 硬件 来 控制 对 Tag 中 特定 数据 段 的 读 写 ， 甚 至 于 一 些 Tag 上 有 
简单 的 操作 系统 ， 人 允许 与 Tag 上 执行 的 代码 进行 一 些 相 对 复杂 的 交互 。 

NFC 总 是 在 一 个 发 起 者 和 一 个 被 动 目标 之 间 发 生 。 发 起 者 发 出 近 场 无 线 电波 ， 这 个 近 场 
可 以 给 被 动 目标 供电 。 发 起 者 一 般 为 Android 设备 ， 被 动 的 目标 包括 不 需要 电源 的 标签 、 卡 
等 ， 也 可 以 是 有 电源 的 设备 ， 如 Android FHL. NFC 技术 为 手机 支付 提供 了 技术 基础 。 

与 蓝牙 和 WIFI 技术 相 比 ，NFC 的 通信 带宽 和 距离 都 要 小 得 多 ， 但 是 它 成 本 低 ， 不 需要 
电源 支持 ， 这 些 都 是 得 天 独 厚 的 应 用 推广 条 件 。 

为 了 推动 NFC 的 发 展 和 普及 ， 业 界 创建 了 一 个 非 赢 利 性 的 标准 组 织 一 一 NFC Forum, 
力求 促进 NEC 技术 的 实施 和 标准 化 ， 确 保 设 备 和 服务 之 间 协 同 合作 。 目 前 ，NFC Forum 在 
全 球 拥有 数 百 个 成 员 ， 包 括 : SONY, Phlips, LG, Motorola, NXP, NEC, =Æ, atoam, 
Intel 等 。2011 年 4 月 ，Google 加 入 到 NFC 论坛 组 织 ， 推 动 了 NFC 技术 的 推广 。 


8.5.2 Android NFC 技术 


Android 提供 了 android.nfc 和 android.nfc.tech 包 ， 它 们 对 NFC 技术 进行 了 支持 。 常 用 类 
介绍 如 下 : 


* NfcManager: Android 设备 的 NFC 适配器 管理 器 ， 可 以 通过 getSystemService 
(String) 获得 对 象 实例 。NfcManager 可 以 获取 到 当前 Android 设备 支持 的 所 有 NFC 
适配器 列表 。 

© NfcAdapter: 代表 设备 的 NFC 适配器 。NFC 适配器 是 进行 NFC 操作 的 入 口 。 通 常情 
况 下 ， 每 个 Android 设备 只 有 一 个 NFC 适配器 ， 可 以 通过 NfcAdapter. 
getDefaultAdapter ( android.content.Context ) 方法 或 者 NfcManager.getDefaultAdapter() 
方法 来 取 当 前 Android 设 备 的 NFC 适配器 。 

* NdefMessage: 代表 NDEF 消息 。NDEF 是 NFC Forum 定义 的 标准 数据 结构 ， 用 于 在 
设备 和 NFC tags 之 间 传 递 数 据 。 一 个 NdefMessage 对 象 包含 多 个 NdefRecord 对 象 。 
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* NdefRecord: 代表 一 条 记录 。 每 条 NDEF 记录 都 有 一 个 MIME 数据 类 型 ， 比 如 文 
本 、URL、 智 慧 型 海报 等 。NDEF 记录 被 存放 在 NDEF 消息 中 。 
* Tag: 表示 被 检测 到 的 NFC 目标 。 可 以 是 一 个 标签 、 一 个 卡片 、 一 个 钥匙 扣 等 等 。 


Android.nfc.tech 包 中 包含 了 对 NFC Tag 进行 查询 和 IO 操作 的 类 。 
如 果 Android 设备 没有 关闭 掉 NFC 功能 ， 当 设备 的 屏幕 没有 被 锁定 时 ，Android 设备 会 
- 直 搜 寻 附 件 的 NFC Tag。 当 一 个 NFC Tag 被 检测 到 ， 一 个 包含 该 NFC Tag 信息 的 Tag 对 象 
将 被 创建 并 且 封 装 到 一 个 Intent 里 ， 然 后 NFC 发 布 系统 将 这 个 Intent 用 startActivity 发 送 到 
已 注册 的 用 于 处 理 这 种 类 型 的 Intent 的 Activity 中 进行 处 理 。 

当 Android 设备 扫描 到 一 个 NFC Tag， 通 用 的 行为 是 自动 搜寻 最 合适 的 Activity 处 理 这 
个 包含 Tag 对 象 的 Intent， 而 不 需要 用 户 来 选择 哪个 Activity 来 处 理 。 因 为 设备 扫描 NFC Tag 
是 在 很 短 的 范围 和 时 间 ， 如 果 让 用 户 选择 的 话 ， 那 就 有 可 能 需要 移动 设备 ， 这 样 将 会 打 断 这 
个 扫描 过 程 。 因 此 开发 者 应 该 开发 只 处 理 需 要 处 理 的 Tag 的 Activity， 以 防止 发 生 让 用 户 选 
择 使 用 哪个 Activity 来 处 理 的 情况 。 

Android 系统 提供 了 一 个 Tag 发 布 系统 (Tag Dispatch System) 帮助 分 析 扫 描 到 的 NFC 
Tag， 从 中 提取 相关 数据 ， 封 装 到 Intent 并 且 定位 到 对 这 些 数据 有 兴趣 的 Activity。 如 果 同 时 
又 过 个 Activity 都 可 以 对 封装 了 Tag 数据 的 Intent 进行 处 理 ， 那 么 会 出 现 一 个 选择 列表 ， 让 
用 户 来 选择 要 处 理 的 Activity。 

Tag 发 布 系统 定义 了 三 种 Intent， 按 照 顺序 优先 级 从 高 到 低 : 


e android.nfc.action NDEF DISCOVERED: 当 一 个 包含 NDEF 负载 的 Tag 被 检测 到 时 
该 Intent 被 启动 ， 这 是 最 高 优先 级 的 Intent。 如 果 检 测 到 的 是 一 个 未 知 的 tag 或 者 不 
包含 NDEF 负载 的 tag， 那 么 该 Intent 不 会 被 启动 。 若 是 NDEF_DISCOVERED Intent 
已 经 被 启动 ， 则 TECH DISCOVERED 和 TAG DISCOVERED Intent 将 不 会 被 启动 。 


处 理 该 Intent 的 Activity 需要 对 应 设置 intent-filter 属性 ， 例 如 : 


<intent-filter> 
<action android:name="android.nfc.action.NDEF DISCOVERED"/> 
«category android:name-"android.intent.category.DEFAULT"/» 
«data android:mimeType-"text/plain" /» 

«/intent-filter» 


表明 当前 Activity 可 以 处 理 NDEF DISCOVERED 类 型 的 Intent， 但 是 其 携带 数据 的 类 型 
需要 是 “text/plain” 类 型 。 


* android.nfc.action TECH_DISCOVERED: 当 一 个 包含 NDEF 负载 的 Tag 被 检测 到 ， 
并 且 没 有 Activity 处 理 NDEF DISCOVERED Intent 时 ， 该 Intent 会 被 启动 。 若 该 
Intent 被 启动 ， 则 TAG. DISCOVERED 不 会 被 启动 。 

* android.nfc.action TAG. DISCOVERED: 当 一 个 包含 NDEF 负载 的 Tag 被 检测 到 ， 并 
且 没 有 Activity 处 理 NDEF DISCOVERED 和 TECH DISCOVERED Intent 时 ， 或 者 
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Tag 被 检测 为 未 知 的 ， 该 Intent 被 启动 。 
总 的 来 说 ，Tag 发 布 系统 的 运行 过 程 如 图 8.11 所 示 。 


NDEF Formatted Tag 


um — od recetas to Yos Intent delivered to 
um — Activity 
* 
Activities rog stered to 
TAG DISCOVERED handie Yes 
| TAG DISCOVERED? 


图 8.11 Tag 发 布 系统 允许 图 


要 进行 NFC 访问 ， 需 要 在 工程 的 AndroidManifest.xml 文件 中 添加 如 下 代码 : 
e 用 于 获取 NEC 硬件 访问 权限 。 


<uses-permission android:name="android.permission.NFC" /> 


e 指定 最 小 SDK 版 本 的 代码 。 支 持 NFC 功能 的 最 小 SDK 版 本 为 API Level 9， 但 是 仅 
支持 有 限 的 Tag 发 布 和 访问 NDEF 信息 ， 不 支持 其 他 的 Tag 的 输入 输出 操作 。API 
Level 10 增加 了 对 Tag 的 读 写 方式 ， 并 添加 了 前 台 NDEF 推 数 据 方式 。API Level 14 
提供 了 将 NDEF 数据 传送 到 其 他 设备 的 方式 。 建 立 SDK 的 最 小 版 本 要 高 于 10。 


<uses-sdk android:minSdkVersion="10"/> 


o 设置 uses-feature 属性 ， 以 便 在 Google Play Store 发布 时 ， 仅 使 具有 NFC 硬件 的 设备 
可 以 搜索 到 。 


<uses-feature android:name="android.hardware.nfc" 
android: required="true" /> 


85.3 ”使 用 前 台 发 布 系统 


前 台 发 布 系统 允许 Activity 截获 到 Intent 并 且 获 得 比 其 他 的 能 够 处 理 该 Intent 的 Activity 
更 高 的 权限 。 使 用 前 台 发 布 系统 涉及 为 Android 系统 构建 一 些 数据 结构 以 便 能 够 发 送 合适 的 
Intent 到 应 用 程序 。 

要 使 用 前 台 发 布 系统 ， 需 要 : 
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(1) f£ Activity 的 onCreate() 方 法 中 添加 以 下 代码 : 


© 创建 一 个 PendingIntent 对 象 ， 以 便当 Android 系统 检测 到 Tag 时 能 够 获取 到 这 个 对 象 
的 详细 信息 。 


PendingIntent pendingIntent-PendingIntent.getActivity ( 
this, 0, new Intent (this, getClass()) .addFlags 
(Intent.FLAG ACTIVITY SINGLE TOP) , 0) ; 


e 定义 用 于 处 理 要 截获 的 Intent 的 Intent Filter。 当 系统 检测 到 NFC Tag 时 ， 前 台 发 布 
系统 会 核实 当前 Activity 的 intent-filter 是 否 与 要 截获 的 Intent HS. FHS, MH 
前 的 Activity 对 Intent 进行 处 理 ; 若 不 符合 ， 则 前 台 发 布 系统 将 Intent 发 送 给 Intent 
发 布 系统 。 下 面 的 代码 处 理 了 所 有 的 MIME 数据 类 型 。 


IntentFilter ndef=new IntentFilter 
(NfcAdapter.ACTION NDEF DISCOVERED) ; 


try { 
ndef.addDataType ("*/*") ; /* Handles all MIME based 
dispatches. 
You should specify only the ones 
that you need. */ 


} 


catch (MalformedMimeTypeException e) { 
throw new RuntimeException ("fail", e) ; 
} 


intentFiltersArray=new IntentFilter[] {ndef, }; 


e 设置 要 处 理 的 Tag Technology 列表 。 


techListsArray=new String[][] { new String[] { NfcF.class.getName()} }; 


(2) Bini onPause()fll onResume( 方 法 来 打开 或 关闭 前 台 发 布 系统 。enableForegroundDispatchO 
方法 只 能 在 主线 程 中 并 且 Activity 在 前 台 时 被 调用 。 另 外 应 该 实行 onNewIntent(0 方 法 对 从 
NEC Tag 中 获取 到 的 数据 进行 处 理 。 相 关 代码 如 下 : 


public void onPause() { 
super.onPause () ; 
mAdapter.disableForegroundDispatch (this) ; 


} 


public void onResume() { 
super.onResume () ; 
mAdapter.enableForegroundDispatch (this, pendingIntent, 
intentFiltersArray, techListsArray) ; 


} 
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public void onNewIntent (Intent intent) { 
Tag tagFromIntent=intent .getParcelableExtra 
(NfcAdapter.EXTRA TAG) ; 
//do something with tagFromIntent 


} 


(3) 读 写 NFC Tag 数据 。 下 列 代码 演示 了 处 理 TAG DISCOVERED Intent Jf H (i Hi 
代 器 从 NFC Tag 中 的 NDEF 数据 的 方法 : 


NdefMessage[] getNdefMessages (Intent intent) { 
// Parse the intent 
NdefMessage[] msgs-null; 
String action-intent.getAction(); 
if (NfcAdapter.ACTION TAG DISCOVERED.equals (action) ) if 
Parcelable[] rawMsgs-intent.getParcelableArrayExtra 
(NfcAdapter.EXTRA NDEF MESSAGES) ; 

if (rawMsgs !-null) { 

msgs-new NdefMessage [rawMsgs . length] ; 
for (int i-0; i«rawMsgs.length; i++) { 

msgs [i]= (NdefMessage) rawMsgs [i]; 

} 
} 


else { 
// Unknown tag type 
byte[] empty-new byte[] (]; 
NdefRecord record-new NdefRecord (NdefRecord.TNF UNKNOWN, empty, empty, 
empty) ; 
NdefMessage msg-new NdefMessage (new NdefRecord[] {record}) ; 
msgs-new NdefMessage[] {msg}; 


} 

} 

else { 

Log.e (TAG, "Unknown intent "+intent) ; 
finish(); 

} 

return msgs; 

} 


下 列 代码 演示 了 写 简单 的 文本 到 NFC Tag 中 的 方法 : 


NdefFormatable tag=NdefFormatable.get (t) ; 

Locale locale-Locale.US; 

final byte[] langBytes=locale.getLanguage() .getBytes 
(Charsets.US ASCII) ; 

String text-"Tag, you're it!"; 

final byte[] textBytes-text.getBytes (Charsets.UTF 8) ; 


final int utfBit-0; 
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final char status= (char) (utfBit+langBytes.length) ; 


final byte[] data=Bytes.concat (new byte[] { (byte) status}, langBytes, 
textBytes) ; 

NdefRecord record-NdefRecord (NdefRecord.TNF WELL KNOWN, 
NdefRecord.RTD TEXT, new byte[0], data) ; 


try { 

NdefRecord[] records={text}; 

NdefMessage message=new NdefMessage (records) ; 
tag.connect () ; 
tag.format (message) ; 


catch (Exception e) { 
//do error handling 


} 


O.Ó uss 


8.6.1 USB 简介 


Android 系统 支持 多 种 USB 外 围 设备 ， 提 供 两 种 模式 来 支持 实现 了 Android 附件 协议 
USB 外 设 接 入 系统 : USB 附件 模式 和 USB 主机 模式 。 

在 USB 附件 模式 下 ， 接 入 的 USB 设备 充当 了 USB 主机 ， 并 为 USB 总 线 供电 。USB 附 
件 的 例子 包括 机 器 人 控制 器 、 诊 断 和 音乐 设备 、 读 卡 器 等 。 这 种 模式 使 不 具备 主机 功能 的 
Android 设备 具有 了 与 USB 硬件 交互 的 能 力 。Android USB 附件 被 设计 来 与 装 有 Android 的 
设备 一 起 工作 ， 并 且 必 须 遵 循 Android 附件 通信 协议 〈 Android accessory communication 
protocol) 。 

在 USB 主机 模式 下 ， Android 设备 扮演 主机 的 角色 。 这 种 设备 的 例子 包括 数码 相机 、 键 
盘 、 鼠 标 和 游戏 手柄 等 。 那 些 适 应 面 很 广 的 USB 设备 可 以 与 Android 应 用 程序 交互 ， 只 要 
Android 系统 可 以 正确 地 与 这 些 设备 进行 通信 。 

图 8.12 展示 了 两 种 模式 的 异同 。 当 Android 设备 处 于 主机 模式 时 ， 它 扮演 USB 主机 的 
角色 并 为 总 线 供 电 。 当 Android 设备 处 于 附件 模式 时 ， 连 接 的 USB 设备 扮演 主机 角色 并 给 总 
线 供电 。 


Power > 
Hast Node Anco powered -£ 
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812 两 种 USB 模式 


USB 的 附件 模式 和 主机 模式 在 Android 3.1 (API level 12) 或 更 高 的 SDK 平台 中 被 直接 
支持 。 在 Android 2.3.4 (API level 10) 系统 中 也 可 以 通过 添加 附加 库 的 方式 来 获得 支持 。 设 
备 生产 商 可 以 选择 是 否 在 设备 的 系统 中 包含 该 附加 库 。 


8.6.2 USB 附件 


Android USB 附件 模式 允许 Android 设备 以 附件 形式 连接 到 USB 主机 上 。 附 件 必须 遵循 
Android Accessory Protocol 协议 。 附 件 模 式 使 得 不 能 以 USB 主机 方式 工作 的 Android 设备 与 
USB 主机 进行 交互 。 

1. API 的 选择 

在 开发 USB 附件 应 用 程序 时 ， 首 先 应 该 考虑 的 问题 是 选择 正确 的 USB 附件 API。 

对 应 Android 3.1 (API Level 12) 及 其 以 上 版 本 的 操作 系统 ，Android SDK 直接 提供 了 
USB 附件 开发 包 ， 名 为 android.hardware.usb 。 

对 于 早期 的 Android 2.3.4 (API Level 10) 版 本 的 操作 系统 ，Android SDK 没有 提供 相应 
的 开发 包 ， 只 能 通过 Google 的 附加 库 来 完成 USB 附件 模式 的 相关 开发 工作 ， 包 名 为 
com.android.future.usb。 实 质 上 Google 的 这 个 附加 库 是 对 Android 框架 API 的 包装 ， 相 当 于 
android.hardware.usb 包 的 一 个 简化 包 ， 仅 支持 附件 模式 的 开发 ， 不 支持 主机 模式 的 开发 。 

由 于 Google 附件 库 是 Android 框架 API 的 包装 库 ， 因 此 支持 USB 附件 的 API 是 相同 
的 。 主 要 有 两 个 类 : 

* UsbManager: 这 个 类 负责 枚 举 连 接 的 USB 附件 设备 ， 并 与 附件 通信 ; 

* UsbAccessory: 表示 一 个 USB 附件 设备 ， 并 且 包 含 了 访问 附件 的 标识 信息 的 API, 


虽然 USB 附件 开发 的 相关 的 类 相同 ， 但 是 在 使 用 方法 上 有 两 处 不 同 。 
e 获取 UsbManager 实例 的 方法 不 同 : 

对 于 Google 附加 库 ， 应 使 用 如 下 代码 获取 UsbManager 的 实例 : 
UsbManager manager-UsbManager.getInstance (this) ; 

对 于 Android 框架 API， 应 该 使 用 如 下 代码 : 

UsbManager manager= (UsbManager) getSystemService 
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(Context .USB SERVICE) ; 


e 当 通过 Intent Filter 对 连接 的 USB 附件 进行 过 滤 时 ， 代 码 有 所 不 同 。 此 时 
UsbAccessory 对 象 会 被 包含 在 Intent 对 象 中 传递 给 应 用 程序 。 


对 于 Google 附加 库 ， 应 该 使 用 如 下 代码 : 


UsbAccessory accessory=UsbManager.getAccessory (intent) ; 


如 果 使 用 的 是 Android 框架 API， 则 应 该 使 用 如 下 代码 : 


UsbAccessory accessory= (UsbAccessory) intent.getParcelableExtra 
(UsbManager.EXTRA ACCESSORY) ; 


2. AndroidManifest.xml 文件 设置 
应 用 程序 的 Manifest 文 件 应 该 做 如 下 设置 : 


e 由 于 并 不 是 所 有 的 Android 设备 都 支持 USB 附件 API， 因 此 需要 在 应 用 程序 的 
Manifest 文件 中 使 用 <uses-feature> 属 性 来 声明 当前 的 应 用 程序 使 用 了 android. 
hardware.usb.accessory 特性 。 

e 如 果 使 用 的 是 Google 附加 库 ， 需 要 使 用 <uses-library> 属 性 添加 com.android.future. 
usb.accessory 库 的 支持 。 

e 根据 选用 的 API 设 置 最 小 SDK 版 本 ， 如 果 是 Google 附加 库 的 话 ， 最 小 API Level 应 
该 为 10， 如 果 使 用 的 是 框架 API， 则 该 值 应 该 为 12。 

e 如果 需 要 当前 应 用 程序 在 USB 附件 连接 时 获得 通知 ， 则 应 该 在 主 Activity 中 为 
android.hardware.usb.action USB ACCESSORY ATTACHED intent 指定 <intent-filter> 
属性 和 <meta-data> 属 性 对 。 其 中 <meta-data> 属 性 指向 了 一 个 外 部 的 XML 资源 文件 ， 
其 中 包含 了 要 检测 的 附件 的 识别 信息 。 

e 在 XML 资源 文件 中 ， 通 过 <usb-accessory> 属 性 为 要 过 滤 的 USB 附件 定义 声明 信息 ， 
该 属性 可 以 包含 manufacture、model 和 version 属性 。 该 资源 文件 被 保存 在 res/xml 文 
件 夹 下 ， 其 文件 名 字 应 该 和 上 面 提 到 的 <meta-data> 中 指定 的 文件 名 字 相 同 (不 含 xml 
后 缓 ) 。 


下 列 代码 演示 了 在 应 用 程序 的 AndroidManifestxml 文件 中 ， 关 于 USB 附件 API 的 设置 
内 容 : 


«manifest ...> 
<uses-feature android:name="android.hardware.usb.accessory" /> 


<uses-sdk android:minSdkVersion="<version>" /> 


<application> 
<uses-library android:name="com.android.future.usb.accessory" /> 
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<activity ...> 


<intent-filter> 
<action 
android:name="android.hardware.usb.action.USB_ACCESSORY_ATTACHED" /> 
</intent-filter> 


<meta-data 
android:name="android.hardware.usb.action.USB_ACCESSORY_ATTACHED" 
android: resource="@xml/accessory filter" /> 
</activity> 
</application> 
</manifest> 


其 中 ， 
<meta-data 


android:name="android.hardware.usb.action.USB_ACCESSORY_ATTACHED" 
android: resource="@xml/accessory filter" /> 


表明 USB 附件 的 相关 信息 ， 包 括 附 件 模型 、 生 产 商 、 版 本 等 信息 被 保存 在 res/xml/ 
xml/accessory_filter.xml 文件 中 。 当 USB 附件 连接 到 Android 主机 时 ， 这 些 信息 都 会 被 发 送 
给 应 用 程序 进行 过 滤 。 该 文件 示例 代码 如 下 : 


<?xml version-"1.0" encoding-"utf-8"?» 
«resources» 

«usb-accessory model-"DemoKit" manufacturer-"Google" version="1.0"/> 
«/resources» 


3. 使 用 USB 附件 


当 用 户 将 USB 附件 连接 到 Android i IN, Android 系统 会 检测 相关 应 用 程序 是 否 对 
接 的 USB 附件 感 兴趣 。 如 果 感 兴趣 ， 则 会 建立 于 USB 附件 的 通信 。 要 达到 这 个 目的 ， iis 
程序 应 该 能 够 完成 以 下 三 点 ; 
© 通过 intent filter 发 现 连接 的 USB 附件 设备 ， 可 以 通过 过 滤 附 件 连接 事件 或 者 枚 举 所 
有 连接 的 USB 附件 设备 并 从 中 查找 合适 的 设备 的 方式 对 附件 进行 发 现 。 
e 向 用 户 要 求 与 USB 附件 进行 通信 的 权限 。 
e 通过 使 用 合适 的 接口 读 写 数 据 的 方式 与 USB 附件 进行 通信 。 


(1) 使 用 intent filter 发 现 附件 的 方式 适合 于 想 让 应 用 程序 自动 检测 附件 的 情况 。 实 行 
这 种 方式 需要 在 应 用 程序 的 manifest 文件 中 为 Activity 添加 android.hardware.usb.action. 
USB ACCESSORY ATTACHED intent 的 过 滤 功能 ， 并 通过 meta-data 属性 指定 对 USB 附件 
信息 进行 描述 的 xml 文 件 。 
Activity 设置 的 相关 代码 如 下 : 
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«activity ...> 


<intent-filter> 
<action 
android:name-"android.hardware.usb.action.USB ACCESSORY ATTACHED" /> 
</intent-filter> 


<meta-data 
android:name="android.hardware.usb.action.USB_ACCESSORY_ATTACHED" 
android: resource="@xml/accessory filter" /> 
</activity> 


资源 文件 accessory_ filter xml 文件 的 内 容 如 下 : 
<?xml version="1.0" encoding="utf-8"?> 


<resources> 

«usb-accessory manufacturer="Google, Inc." model="DemoKit" 
version="1.0" /> 
</resources> 


这 样 ， 当 符合 要 求 的 USB 附件 被 连接 到 USB 主机 上 ， 其 产生 的 Intent 对 象 就 会 被 该 
Activity 截获 ， 并 从 中 获取 到 代表 USB 附件 的 UsbAccessory 对 象 。 
对 于 Google 附加 库 ， 相 关 代码 如 下 : 


UsbAccessory accessory=UsbManager.getAccessory (intent) ; 


对 于 框架 API， 相 关 代码 如 下 : 


UsbAccessory accessory= (UsbAccessory) intent .getParcelableExtra 
(UsbManager.EXTRA ACCESSORY) ; 


(2) 枚 举 所 有 连接 的 USB 附件。 获取 所 有 连接 到 主机 的 USB 附件 的 代码 如 下 : 


UsbManager manager= (UsbManager) getSystemService 
(Context.USB SERVICE) ; 
UsbAccessory[] accessoryList-manager.getAcccessoryList(); 


(3) 获取 访问 USB 附件 的 权限 。 在 与 USB 附件 建立 通信 之 前 ， 必 须 明 确 要 向 用 户 要 求 
访问 权限 。 通 过 调用 requestPermission() 方 法 向 用 户 显示 一 个 对 话 框 ， 要 求 与 附件 建立 连接 
的 权限 。 用 户 单 击 该 对 话 框 后 会 生成 一 个 Intent 对 象 并 广播 出 去 。 因 此 该 应 用 程序 需要 创建 

-个 BroadcastReceiver 来 接收 该 mtent 对 象 ， 并 从 中 获取 用 户 授权 。 
创建 BroadcastReceiver 的 相关 示例 代码 如 下 : 


private static final String ACTION USB PERMISSION= 
"com.android.example.USB_PERMISSION"; 
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private final BroadcastReceiver mUsbReceiver=new BroadcastReceiver ( { 


public void onReceive (Context context, Intent intent) { 
String action-intent.getAction(); 
if (ACTION USB PERMISSION.equals (action) ) { 
synchronized (this) { 
UsbAccessory accessory- (UsbAccessory) 
intent.getParcelableExtra (UsbManager.EXTRA ACCESSORY) ; 


if (intent.getBooleanExtra 


(UsbManager.EXTRA PERMISSION GRANTED, false) ) { 
if (accessory !-null) { 
//call method to set up accessory communication 


} 
} 


else { 
Log.d (TAG, "permission denied for accessory 


"*accessory) ; 


}; 

该 BroadcastReceiver 被 创建 后 ， 应 该 在 Activity 的 onCreate(0 方 法 中 进行 注册 。 相 关 代 
码 如 下 : 

UsbManager mUsbManager= (UsbManager) getSystemService 
(Context.USB SERVICE) ; 


private static final String ACTION USB PERMISSION- 
"com.android.example.USB PERMISSION"; 


mPermissionIntent-PendingIntent.getBroadcast (this, 0, new Intent 


(ACTION USB PERMISSION) , 0) ; 
IntentFilter filter-new IntentFilter (ACTION USB PERMISSION) ; 


registerReceiver (mUsbReceiver, filter) ; 


显示 向 用 户 要 求 访问 附件 权限 的 对 话 框 ， 需 要 使 用 requestPermissionQ Jj ik, Vf 
如 下 H 


UsbAccessory accessory; 


mUsbManager.requestPermission (accessory, mPermissionIntent) ; 


(4) 5 USB 附件 进行 通信 。 可 以 通过 UsbManager 示例 获取 一 个 文件 描述 符 
(FileDescriptor) ， 并 通过 该 文件 描述 符 建 立 输入 输出 流 ， 进 而 达到 与 USB 附件 通信 的 目 
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的 。 与 USB 附件 通信 的 过 程 应 该 写 在 一 个 单独 的 线程 里 ， 避 免 阻塞 UI 线程。 下 列 代码 演示 
了 打开 USB 附件 并 进行 通信 的 过 程 : 


UsbAccessory mAccessory; 
ParcelFileDescriptor mFileDescriptor; 
FileInputStream mInputStream; 
FileOutputStream mOutputStream; 


private void openAccessory () { 

Log.d (TAG, "openAccessory: "+accessory) ; 

mFileDescriptor-mUsbManager.openAccessory (mAccessory) ; 

if (mFileDescriptor !=null) { 
FileDescriptor fd-mFileDescriptor.getFileDescriptor(); 
mInputStream-new FileInputStream (fd) ; 
mOutputStream=new FileOutputStream (fd) ; 
Thread thread-new Thread (null, this, "AccessoryThread") ; 
thread.start(); 


) 


在 线程 的 run() 方 法 中 ， 可 以 通过 FileInputStream 和 FileOutputStream 进行 读 写 附件 的 操 
作 。 当 从 附件 中 使 用 FileInputStream 读 取 信息 时 ， 应 该 保证 用 于 保存 读 取 数据 的 缓冲 区 的 大 
小 足够 容纳 USB 数据 包 中 的 数据 。Android Accessory Protocol 中 支持 USB 数据 包 缓 冲 区 最 
大 到 16384 字 节 。 为 了 保证 信息 传输 的 安全 ， 建 立 声明 16384 字 节 长 度 的 缓冲 区 。 

(5) 结束 与 USB 附件 的 通信 。 当 与 USB 附件 的 通信 结束 或 者 附件 被 从 系统 中 断 开 的 时 
候 ， 应 该 使 用 close0 方 法 关闭 文件 描述 符 。 下 列 代码 定义 了 一 个 监听 附件 被 移 除 的 事件 的 


BroadcastReceiver: 


BroadcastReceiver mUsbReceiver-new BroadcastReceiver() { 
public void onReceive (Context context, Intent intent) 1 


String action-intent.getAction(); 


if (UsbManager.ACTION USB ACCESSORY DETACHED.equals (action) ) { 
UsbAccessory accessory- (UsbAccessory) 
intent.getParcelableExtra (UsbManager.EXTRA ACCESSORY) ; 
if (accessory !=null) { 
// call your method that cleans up and closes 
communication with the accessory 
} 
} 


在 应 用 程序 中 创建 该 BroadcastReceiver， 而 不 是 在 应 用 程序 的 Manifest 配置 文件 中 ， 这 
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样 可 以 保证 只 有 Activity 运行 时 才 对 USB 附件 断 开 事件 进行 处 理 。 而 附件 断 开 事件 会 只 被 发 
送 给 当前 运行 的 Activity， 而 不 是 被 广播 给 所 有 的 应 用 程序 。 


8.6 


.3 USB 主机 


当 Android 设备 运行 在 USB 主机 模式 ， 它 就 像 一 个 真正 的 USB 主机 ， 给 USB 总 线 供 电 


并 枚 举 所 有 连接 的 USB 附件 设备 。USB 主机 模式 仅 在 Android 3.1 及 其 更 高 版 本 的 系统 中 被 
支持 。 


1. 相关 API 介绍 
与 USB 主机 相关 的 API 都 被 保存 在 android.hardware.usb 包 中 ， 相 关 类 介绍 如 下 : 


e UsbManager: 用 于 枚 举 连 接 的 USB 附件 设备 ， 并 与 USB 附件 进行 通信 。 
* UsbDevice: 表示 一 个 连接 的 USB 附件 设备 ， 包 含 了 访问 该 设备 的 标识 信息 、 接 口 和 


端点 的 相关 方法 。 


© UsbInterface: 表示 USB 设备 的 一 个 接口 ， 用 于 定义 USB 设备 的 一 系列 功能 。 一 个 


设备 可 以 有 一 个 或 者 多 个 接口 ， 这 些 接口 可 用 于 通信 。 


© UsbEndpoint: 表示 一 个 接口 的 端点 ， 相 当 于 接口 通信 的 通道 。 一 个 接口 可 以 拥有 一 


个 或 者 多 个 端点 ， 通 常 拥有 输入 和 输出 两 个 端点 用 于 设备 的 双向 通信 。 


* UsbDeviceConnection: 表示 一 个 到 USB 设备 的 连接 ， 用 于 在 端点 上 传输 数据 。 这 个 


类 允许 用 户 以 同步 或 者 非 同步 的 方式 双向 传输 数据 。 

* UsbRequest 表示 一 个 通过 UsbDeviceConnection 与 USB 设备 进行 通信 的 异步 请 求 。 

© UsbConstants: 定义 了 一 些 USB 常量 ， 这 些 常量 与 Linux 内 核 中 linux/usb/ch9.h 的 定 
义 相 同 。 


在 大 多 数 情况 下 ， 开 发 者 需要 使 用 上 面 提 到 的 所 有 的 类 来 进行 与 USB 设备 的 连接 


(UsbRequest 类 只 有 在 要 求 异步 通信 时 才 会 被 使 用 ) 。 通 常情 况 下 ， 开 发 者 需要 通过 
UsbManager 实例 去 获取 所 需 的 UsbDevice 实例 ， 进 而 从 UsbDevice 实例 中 查找 合适 的 
UsbInterface， 并 确定 要 用 于 通信 的 UsbEndpoint， 最 后 建立 UsbDeviceConnection 建立 与 
USB 设备 的 通信 。 
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e 由 于 并 不 是 所 有 的 Android 设备 都 支持 USB 附件 API， 因 此 需要 在 应 用 程序 的 
Manifest 文件 中 使 用 <uses-feature> 属 性 来 声明 当前 的 应 用 程序 使 用 了 android. 
hardware.usb.host 特性 。 

e 设置 最 小 SDK 版 本 ， 该 值 应 该 大 于 12， 因 为 在 早期 的 Android SDK 版 本 中 不 支持 
USB 主机 模式 。 

e 如 果 需 要 当前 应 用 程序 在 USB 附件 连接 时 获得 通知 ， 则 应 该 在 主 Activity 中 为 
android.hardware.usb.action USB ACCESSORY ATTACHED intent 指定 <intent-filter> 
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属性 和 <meta-data> 属 性 对 。 其 中 <meta-data> 属 性 指向 了 一 个 外 部 的 XML 资源 文件 ， 
其 中 包含 了 要 检测 的 附件 的 识别 信息 。 

© 在 XML 资源 文件 中 ， 通 过 <usb-device> 属 性 为 要 过 滤 的 USB 附件 定义 相关 信息 ， 该 
属性 可 以 包含 vendor-id, product-id. class. subclass. protocol ( device or interface ) 
等 属性 。 如 果 想 过 滤 特 定 设备 ， 则 需要 使 用 vendor-id 和 product-id 属性 ; 如 果 想 过 
滤 一 类 设备 ， 比 如 大 容量 存储 设备 或 者 数码 相机 ， 则 应 该 使 用 class. subclass 和 
protocol 属性 ; 如 果 这 些 属性 一 个 也 不 指定 ， 则 所 有 的 USB 设备 都 不 会 被 过 滤 掉 。 该 
资源 文件 被 保存 在 res/xml 文件 夹 下 ， 其 文件 名 字 应 该 和 上 面 提 到 的 <meta-data> 中 指 
定 的 文件 名 字 相 同 (RE xml GAR) . 


下 列 示例 代码 演示 如 何 定义 Manifest 文件 : 


<manifest ...> 
<uses-feature android:name="android.hardware.usb.host" /> 
<uses-sdk android:minSdkVersion="12" /> 


<application> 
cactlvityl > 


<intent-filter> 
<action 
android:name-"android.hardware.usb.action.USB DEVICE ATTACHED" /> 
«/intent-filter» 


«meta-data 
android:name-"android.hardware.usb.action.USB DEVICE ATTACHED" 
android:resource-"exml/device filter" /> 
«/activity» 
«/application» 
«/manifest» 


在 这 个 示例 中 ， 自 由 文件 被 放置 在 res/xml/device_filterxml 中 ， 相 关 代码 如 下 : 


<?xml version="1.0" encoding="utf-8"?> 


«resources» 
«usb-device vendor-id-"1234" product-id-"5678" class-"255" 
subclass="66" protocol-"1" /> 
</resources> 


3. 使 用 USB 设备 

当 用 户 将 USB 设备 连接 到 Android 设备 时 ，Android 系统 会 检测 相关 应 用 程序 是 否 对 
接 的 USB 设备 感 兴趣 。 如 果 感 兴趣 ， 则 会 建立 与 USB 设备 的 通信 。 要 达到 这 个 目的 ， 应 用 
程序 应 该 能 够 完成 以 下 : 
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e 通过 intent filter 发 现 连接 的 USB 设备 ， 可 以 通过 过 滤 设 备 连 接 事件 或 者 枚 举 所 有 连 
接 的 USB 设备 并 从 中 查找 合适 的 设备 的 方式 对 设备 进行 发 现 。 
日 向 用 户 要 求 与 USB 设备 进行 通信 的 权限 。 
e 通过 使 用 合适 的 接口 读 写 数据 的 方式 与 USB 设备 进行 通信 。 
(1) 使 用 intent filter 发 现 设备 的 方式 适合 于 想 让 应 用 程序 自动 检测 设备 的 情况 。 实 行 
这 种 方式 需要 在 应 用 程序 的 manifest 文件 中 为 Activity 添加 android.hardware.usb.action. USB _ 
ACCESSORY ATTACHED intent 的 过 滤 功 能 ， 并 通过 meta-data 属性 指定 对 USB 设备 信息 进 
行 描述 的 xml 文件 。 
Activity 设置 的 相关 代码 如 下 : 
«activity -.-» 
disse filter» 


«action 


android:name-"android.hardware.usb.action.USB ACCESSORY ATTACHED" /> 
«/intent-filter» 


«meta-data 
android:name-"android.hardware.usb.action.USB ACCESSORY ATTACHED" 
android:resource-"exml/device filter" /> 
«/activity» 


资源 文件 device filter xml 文件 的 内 容 如 下 : 
<?xml version-"1.0" encoding-"utf-8"?» 


«resources» 
«usb-device vendor-id-"1234" product-id-"5678" /> 
«/resources» 


这 样 ， 当 符合 要 求 的 USB 设备 被 连接 到 USB 主机 上 ， 其 产生 的 Intent 对 象 就 会 被 该 
Activity 截获 ， 并 从 中 获取 到 代表 USB 设备 的 UsbAccessory 对 象 。 


UsbAccessory accessory- (UsbAccessory) intent.getParcelableExtra 
(UsbManager.EXTRA DEVICE) ; 


(2) 枚 举 所 有 连接 的 USB 设备 。 获 取 所 有 连接 到 主机 的 USB 设备 的 代码 如 下 : 


UsbManager manager= (UsbManager) getSystemService 
(Context.USB SERVICE) ; 


HashMap<String, UsbDevice»deviceList-manager.getDeviceList(); 
UsbDevice device-deviceList.get ("deviceName") ;; 
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UsbManager manager= (UsbManager) getSystemService 
(Context .USB SERVICE) ; 


HashMap<String, UsbDevice>deviceList=manager.getDeviceList () ; 
Iterator«UsbDevice»deviceIterator-deviceList.values().iterator(); 
while (deviceIterator.hasNext ()) { 


UsbDevice device-deviceIterator.next() 
//your code 


} 


(3) 获取 访问 USB 设备 的 权限 。 在 与 USB 设备 建立 通信 之 前 ， 必 须 明 确 要 向 用 户 要 
求 访问 权限 。 通 过 调用 requestPermission() 方 法 向 用 户 显 示 一 个 对 话 框 ， 要 求 与 设备 建立 连 
接 的 权限 。 用 户 单 击 该 对 话 框 后 会 生成 一 个 Intent 对 象 并 广播 出 去 。 因 此 该 应 用 程序 需要 创 
建 一 个 BroadcastReceiver 来 接收 该 Intent 对 象 ， 并 从 中 获取 用 户 授 权 。 

创建 BroadcastReceiver 的 相关 示例 代码 如 下 : 


private static final String ACTION USB PERMISSION= 
"com.android.example.USB PERMISSION"; 
private final BroadcastReceiver mUsbReceiver=new BroadcastReceiver () { 


public void onReceive (Context context, Intent intent) { 
String action=intent.getAction() ; 
if (ACTION_USB_PERMISSION.equals (action) ) { 
synchronized (this) { 


UsbDevice device= (UsbDevice) intent.getParcelableExtra 
(UsbManager.EXTRA DEVICE) ; 


if (intent.getBooleanExtra 
(UsbManager.EXTRA PERMISSION GRANTED, false) ) { 


if (device !=null) { 
//call method to set up device communication 


} 

} 

else { 
Log.d (TAG, "permission denied for device 

"4device) ; 
} 
} 
} 
} 
J; 


iX BroadcastReceiver 被 创建 后 ， 应 该 在 Activity 的 onCreate() 方 法 中 进行 注册 。 相 关 代 
码 如 下 : 


UsbManager mUsbManager= (UsbManager) getSystemService 
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(Context.USB SERVICE) ; 


private static final String ACTION USB PERMISSION- 
"com.android.example.USB PERMISSION"; 


mPermissionIntent-PendingIntent.getBroadcast (this, 0, new Intent 


(ACTION USB PERMISSION) , 0) ; 


IntentFilter filter-new IntentFilter (ACTION USB PERMISSION) ; 
registerReceiver (mUsbReceiver, filter) ; 


显示 向 用 户 要 求 访问 设备 权限 的 对 话 框 ， 需 要 使 用 requestPermission () 方 法 ， 代 


码 如 下 : 


UsbAccessory accessory; 
mUsbManager.requestPermission (accessory, mPermissionIntent) ; 


(4) 与 USB 设备 进行 通信 。 与 USB 设备 进行 通信 可 以 异步 ， 也 可 以 同步 。 无 论 在 那 


种 情况 下 ， 与 USB 设备 通信 的 过 程 都 应 该 在 一 个 单独 的 线程 里 被 执行 ， 以 避免 阻塞 UI 线 


程 。 


为 了 合理 地 创建 于 USB 设备 的 通信 ， 开 发 者 需要 获取 到 要 通信 设备 的 适合 的 UsbInterface 


和 UsbEndpoint 对 象 ， 并 在 该 端点 上 建立 UsbDeviceConnection 并 发 送 通信 请 求 。 


总 体 来 说 ， 代 码 编写 应 该 完成 以 下 功能 : 

e 检查 UsbDevice 对 象 的 属性 ， 例 如 product-id、vendor-id 等 以 确认 是 否 是 要 和 当前 设 
备 进行 通信 。 

© 获取 合适 的 UsbInterface 和 UsbEndpoint 对 象 用 于 通信 。 

e 通过 UsbEndpoint 对 象 打 开 UsbDeviceConnection. 

o 在 端点 上 使 用 bulkTransferQOorcontrolTransfer0 传 输 数 据 。 该 过 程 应 该 在 单独 的 线程 中 
进行 。 


下 列 代 码 演示 了 使 用 同步 方式 进行 数据 传输 的 过 程 ， 该 示例 仅 用 于 演示 ， 在 真正 的 开发 


过 程 中 ， 应 该 注意 选择 合适 的 接口 和 端点 ， 并 且 在 单独 的 线程 中 进行 数据 传输 。 


private Byte[] bytes 
private static int TIMEOUT=0; 
private boolean forceClaim=true; 


UsbInterface intf=device.getInterface (0) ; 

UsbEndpoint endpoint=intf.getEndpoint (0) ; 

UsbDeviceConnection connection=mUsbManager.openDevice (device) ; 
connection.claimInterface (intf, forceClaim) ; 

connection.bulkTransfer (endpoint, bytes, bytes.length, TIMEOUT) ; //do 


in another thread 
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进行 异步 数据 传输 使 用 UsbRequest 类 来 初始 化 并 将 一 根 异步 请 求 放 入 请 求 队列 ， 然 后 
调用 requestWait0 方 法 等 待 结果 。 

G) 结束 与 USB 设备 的 通信 。 当 与 USB 设备 的 通信 结束 或 者 设备 被 从 系统 中 断 开 的 时 
候 ， 应 该 通过 调用 releaseInterface() 方 法 和 close0 方 法 关闭 UsbInterface 和 UsbDeviceConnection. 
下 列 代 码 定义 了 一 个 监听 设备 被 移 除 的 事件 的 BroadcastReceiver: 


BroadcastReceiver mUsbReceiver=new BroadcastReceiver () { 
public void onReceive (Context context, Intent intent) { 
String action-intent.getAction(); 


if (UsbManager.ACTION USB ACCESSORY DETACHED.equals (action) ) { 
UsbAccessory accessory- (UsbAccessory) 
intent.getParcelableExtra (UsbManager.EXTRA DEVICE) ; 
if (accessory !-null) { 
// call your method that cleans up and closes 
communication with the device 


} 
} 
) 
E 


在 应 用 程序 中 创建 该 BroadcastReceiver， 而 不 是 在 应 用 程序 的 Manifest 配置 文件 中 ， 这 
样 可 以 保证 只 有 Activity 运行 时 才 对 USB 设备 断 开 事件 进行 处 理 。 而 设备 断 开 事 件 会 只 被 发 
送 给 当前 运行 的 Activity， 而 不 是 被 广播 给 所 有 的 应 用 程序 。 


8.7.1 SIP 简介 


Android 系统 提供 了 支持 SIP (Session Initiation Protocol) 的 API， 人 允许 开发 者 添加 基于 
SIP 的 因特网 电话 特性 到 自己 的 应 用 程序 中 。Android 包含 一 个 完整 的 SIP 协议 栈 ， 整 合 了 允 
许 轻 松 创 建 来 电 和 去 电 的 电话 管理 服务 ， 而 不 必 开 发 者 直接 参与 管理 会 话 、 传 输 层 通 信 、 音 
频 录 制 等 工作 。 

目前 SIP 已 经 被 成 功 应 用 于 视频 会 议和 即时 消息 中 ， 其 应 用 程序 开发 需要 基于 Android 
2.3 (API Level 9) 以 上 的 系统 。SIP 运行 于 无 线 数据 连接 ， 通 过 AVD 无 法 调试 。 在 SIP 应 用 
程序 通信 会 话 中 的 每 一 个 参与 者 都 必须 拥有 一 个 S 卫 账号 。 
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8.7.2 +H% API 


Android SDK 中 与 SP 开发 相关 的 类 和 接口 被 放置 在 android.net.sip 包 中 ， 相 关 类 和 接口 


介绍 如 下 : 


SipAudioCall: 用 于 处 理 基 于 SIP 的 因特网 音频 呼叫 。 

SipAudioCallListener: 用 于 处 理 SIP 呼叫 事件 ， 如 接收 到 呼叫 和 对 外 呼叫 事件 。 

SipErrorCode: 定义 了 SP 行为 的 错误 代码 。 

SipManager: 提供 了 SIP 任务 的 相关 API， 例 如 初始 化 SIP 连接 ， 提 供 对 相关 SIP JR 

务 的 访问 等 。 

SipProfile: 定义 了 一 个 SIP 配置 文件 ， 包 括 SIP 账户 、 域 和 服务 器 信息 等 。 

© SipProfile.Builder: 创建 SIP 配置 信息 的 的 玫 助 类 。 

© SipSession: 代表 一 个 与 SIP 对 话 框 相关 联 的 SIP 会 话 或 者 一 个 单独 的 无 对 话 框 的 事 
务 。 

© SipSessionlistener: 针对 于 SIP 会 话 事件 的 监听 器 ， 例 如 会 话 被 注册 或 者 一 个 电话 正 
在 呼出 事件 。 

© SipSession.State: 定义 了 SIP 会 话 的 状态 信息 ， 例 如 注册 、 呼 出 、 呼 入 等 。 

© SipRegistrationListener: 一 个 用 于 监听 SIP 注册 事件 的 接口 。 


8.73 Manifest 文件 配置 


要 开发 基于 SIP 的 应 用 程序 ， 必 须 使 用 Android 2.3 以 上 版 本 的 设备 ， 但 是 并 不 是 所 有 


Android 2.3 以 上 版 本 的 设备 都 支持 SIP 应 用 程序 。 
为 应 用 程序 添加 SIP 支持 ， 需 要 在 应 用 程序 的 配置 文件 AndroidManifestxml 中 添加 如 下 
内 容 : 


© 添加 使 用 SIP 和 因特网 的 权限 : 


<uses-permission android:name="android.permission.USE_SIP" /> 
<uses-permission android:name="android.permission.INTERNET" /> 


e 确保 应 用 程序 只 可 以 被 安装 在 支持 SIP 的 设备 上 ， 在 Manifest 文 件 中 添加 以 下 代码 : 


<uses-sdk android:minSdkVersion="9" /> 
<uses-feature android:name="android.hardware.sip.voip" /> 


e 如 果 应 用 程序 被 设计 为 接收 呼叫 ， 则 必须 定义 一 个 receiver: 


<receiver android:name=".IncomingCallReceiver" android:label="Call 


Receiver"/> 
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<?xml version="1.0" encoding="utf-8"?> 


«manifest xmlns:android-"http://schemas.android.com/apk/res/android" 
package-"com.example.android.sip"» 


«receiver android:name-".IncomingCallReceiver" android:label="Call 
Receiver"/» 


«uses-sdk android:minSdkVersion-"9" /> 
«uses-permission android:name-"android.permission.USE SIP" /» 
«uses-permission android:name-"android.permission.INTERNET" /> 


«uses-feature android:name-"android.hardware.sip.voip" 
android:required-"true" /> 
«uses-feature android:name-"android.hardware.wifi" 
android:required-"true" /» 
«uses-feature android:name-"android.hardware.microphone" 
android:required-"true" /» 
«/manifest» 


8.74 创建 SipManager 对 象 
要 使 用 SIPAPI， 必 须 创 建 SipManager 示例。SipManager 用 于 处 理 : 


e 初始 化 SIP 会 话 。 

e 初始 化 并 接收 呼叫 。 

© 对 SIP 提供 者 进行 注册 和 注销 。 
e 核实 会 话 连 接 。 


创建 SipManager 对 象 代码 如 下 : 
public SipManager mSipManager=null; 


if (mSipManager--null) { 
mSipManager-SipManager.newInstance (this) ; 
} 


8.7.5 注册 SIP 服务 器 


在 典型 的 Android SIP 应 用 程序 中 包含 一 个 或 多 个 用 户 ， 每 个 用 户 都 必须 有 一 个 SIP 账 
户 。 在 SIP 应 用 程序 中 ，SIP 账户 用 SipProfile 对 象 表示 。 

SipProfile 定义 了 SIP 配置 简 表 ， 包 括 SP 账户 以 及 域 和 服务 器 信息 。 与 运行 应 用 程序 的 
设备 上 的 SIP 账户 相关 联 的 配置 简 表 叫做 本 地 简 表 ; 会 话 连接 到 的 简 表 叫做 对 等 简 表 。 当 
SIP 应 用 程序 使 用 本 地 SipProfile 登录 到 SIP 服务 器 ，SipProfile 帮助 SP 服务 器 高 效 地 将 当前 
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设备 注册 为 SP 呼叫 的 目的 地 。 
创建 SipProfile 对 象 代 码 如 下 : 


public SipProfile mSipProfile-null; 


SipProfile.Builder builder-new SipProfile.Builder (username, domain) ; 
builder.setPassword (password) ; 
mSipProfile-builder.build(); 


下 列 代码 中 SipManager 打 开本 地 简 表 ， 用 于 拨打 或 者 接收 SIP 呼叫 : 


Intent intent=new Intent(); 

intent.setAction ("android.SipDemo. INCOMING CALL") ; 

PendingIntent pendingIntent-PendingIntent.getBroadcast (this, 0, 
intent, Intent.FILL_IN DATA) ; 

mSipManager.open (mSipProfile, pendingIntent, null) ; 


下 列 代码 为 SipManager 注册 了 SipRegistrationListener 接口 ， 该 接口 用 于 跟踪 SipProfile 
是 否 在 SIP 服务 提供 者 处 成 功 注册 。 


mSipManager.setRegistrationListener (mSipProfile.getUriString(), new 
SipRegistrationListener () { 


public void onRegistering (String localProfileUri) { 
updateStatus ("Registering with SIP Server...") ; 
} 


public void onRegistrationDone (String localProfileUri, long 
expiryTime) { 
updateStatus ("Ready") ; 
} 


public void onRegistrationFailed (String localProfileUri, int 
errorCode, 
String errorMessage) ( 
updateStatus ("Registration failed. Please check settings.") ; 


} 
下 列 代码 演示 了 配置 简 表 使 用 结束 后 ， 如 何 关闭 简 表 ， 并 从 服务 器 注销 设备 信息 。 


public void closeLocalProfile() { 
if (mSipManager--null) { 
return; 
} 


try { 
if (mSipProfile !=null) { 
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mSipManager.close (mSipProfile.getUriString()) ; 


} catch (Exception ee) { 
Log.d ("WalkieTalkieActivity/onDestroy", "Failed to close local 


profile.", ee) ; 
} 
} 


87.6 ”挨打 音频 电话 
要 使 用 SIP 拨打 语音 电话 ， 需 要 满足 如 下 条 件 : 
e 一 个 SipProfile 对 象 ， 用 于 拨打 电话 ; 一 个 有 效 的 SIP 地 址 ， 用 于 接收 电话 。 
e 一 个 SipManager 对象。 
为 了 拨打 音频 电话 ， 需 要 创建 SipAudioCall Listener 对 象 。 大 部 分 的 客户 端 与 SIP 栈 之 
间 的 交互 都 是 通过 接口 进行 的 。 下 列 代码 演示 了 呼叫 建立 后 接口 如 何 进行 处 理 : 
SipAudioCall.Listener listener=new SipAudioCall.Listener() { 


GOverride 
public void onCallEstablished (SipAudioCall call) { 


call.startAudio() ; 
call.setSpeakerMode (true) ; 


call.toggleMute () ; 


} 


@Override 
public void onCallEnded (SipAudioCall call) { 


// Do something. 


} 

h 

SipAudioCallListener 接口 创建 后 ， 通 过 SipManagermakeAudioCall(0 方 法 进行 音频 呼 
叫 。 该 方法 有 四 个 参数 ， 分 别 是 : 

e 本 地 SIP 配 置 简 表 (呼叫 者 ) 。 

e 对 等 SOP 配置 简 表 (被 呼叫 者 ) 。 

* SipAudioCall.Listener 接口 。 

。 超时 时 间 ， 单 位 是 秒 。 
进行 音频 呼叫 的 代码 如 下 : 


call=mSipManager .makeAudioCall (mSipProfile.getUriString(), sipAddress, 
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listener, 30) ; 


87.7 ”接收 呼叫 


为 了 接收 呼叫 ，SIP 应 用 程序 必须 包含 一 个 BroadcastReceiver 的 子 类 ， 以 便当 有 来 电 时 
用 于 对 Intent 对 象 进行 处 理 。 为 此 ， 需 要 在 应 用 程序 中 完成 以 下 几 步 : 


* 在 AndroidManifestxml 文 件 中 声明 <receiver>。 例 如 : 


«receiver android:name-".IncomingCallReceiver" android:label-"Call 
Receiver"/>. 


e 实现 声明 的 BroadcastReceiver 的 子 类 ， 例 如 IncomingCallReceiver. 

e 使 用 PendingIntent 对 象 初始 化 本 地 SipProfile。 当 有 来 电 时 ， 该 PendingIntent 会 启动 
BroadcastReceiver 的 子 类 。 

e 设置 intent filter， 用 于 过 滤 来 电 时 产生 的 intent, 


下 列 代码 定义 了 一 个 用 于 处 理 来 电 的 BroadcastReceiver: 


/*** Listens for incoming SIP calls, intercepts and hands them off to 
WalkieTalkieActivity. 
en 
public class IncomingCallReceiver extends BroadcastReceiver { 
/** 
* Processes the incoming call, answers it, and hands it over to 


the 
* WalkieTalkieActivity. 
* Gparam context The context under which the receiver is running. 


* Gparam intent The intent being received. 

ey 

GOverride 

public void onReceive (Context context, Intent intent) [ 


SipAudioCall incomingCall-null; 


try { 
SipAudioCall.Listener listener=new SipAudioCall.Listener () { 


GOverride 
public void onRinging (SipAudioCall call, SipProfile 
caller) { 


try { 
call.answerCall (30) ; 


} catch (Exception e) { 
e.printStackTrace(); 


} 
} 
) 


WalkieTalkieActivity wtActivity- (WalkieTalkieActivity) 
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incomingCall=wtActivity.mSipManager.takeAudioCall (intent, 


context ; 


listener) ; 
incomingCall.answerCall (30) ; 
incomingCall.startAudio() ; 
incomingCall.setSpeakerMode (true) ; 
if (incomingCall.isMuted()) { 
incomingCall.toggleMute|(); 


} 
wtActivity.call-incomingCall; 
wtActivity.updateStatus (incomingCall) ; 
) catch (Exception e) { 
if (incomingCall !-null) { 
incomingCall.close(); 


设置 用 于 接收 来 电 的 intent filter 的 相关 代码 如 下 : 


public SipManager mSipManager-null; 
public SipProfile mSipProfile-null; 


Intent intent-new Intent(); 

intent.setAction ("android.SipDemo.INCOMING CALL") ; 

PendingIntent pendingIntent-PendingIntent.getBroadcast (this, 0, 
intent, Intent.FILL IN DATA) ; 

mSipManager.open (mSipProfile, pendingIntent, null) ; 


intent filter 信息 可 以 在 应 用 程序 的 Manifest 文件 中 被 注册 ， 也 可 以 像 下 面 代码 演示 的 那 
样 在 Activity 的 onCreate0 方 法 中 被 注册 。 相 关 代码 如 下 : 


public class WalkieTalkieActivity extends Activity implements 
View.OnTouchListener { 


public IncomingCallReceiver callReceiver; 


GOverride 
public void onCreate (Bundle savedInstanceState) { 


IntentFilter filter=new IntentFilter() ; 
filter.addAction ("android.SipDemo.INCOMING CALL") ; 


callReceiver=new IncomingCallReceiver(); 
this.registerReceiver (callReceiver, filter) ; 
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8.8 we 


本 章 主要 讲解 了 Android 平台 上 网 络 通信 的 相关 内 容 ， 主 要 包括 因特网 通信 中 常用 的 
HTTP 通信 和 Socket 通信 以 及 近 距 离 通信 中 的 蓝牙 通信 和 WIFI 通信 ， 并 详细 介绍 了 网 络 通 
信 相 关 的 各 个 接口 和 类 的 使 用 方法 。 在 HTTP 通信 中 ， 介 绍 了 常用 的 HttpURLConnection 和 
HttpClient 接口 的 使 用 方法 ， 以 及 使 用 GET 和 POST 方法 获取 网 络 资源 的 方法 ;在 Socket 通 
信 中 ， 介 绍 了 客户 端 和 服务 器 端 Socket 的 编写 方法 ; 在 蓝牙 通信 部 分 ， 讲 解 了 蓝牙 通信 过 程 
中 涉及 的 相关 内 容 ， 例 如 探测 并 开启 手机 的 蓝牙 功能 、 蓝 牙 服 务 搜索 、 建 立 蓝牙 连接 等 ， 
WIFI 通信 部 分 讲解 了 使 用 WIFI 进行 通信 的 方法 。 每 种 通信 方式 都 对 应 编写 了 一 个 实例 ， 读 
者 可 以 从 实例 出 发 ， 开 发 自己 的 网 络 通信 应 用 程序 。 

此 外 ， 本 章 还 介绍 了 Android 的 NFC 技术 ， 该 技术 用 于 近 距 离 通信 ， 通 信 对 象 可 以 是 无 
源 设备 。 该 技术 为 手机 支付 应 用 程序 的 开发 提供 了 基础 。Android 的 USB 技术 允许 Android 
设备 以 USB 附件 方式 和 USB 主机 方式 与 其 他 USB 设备 进行 通信 。SIP 技术 为 Android 设备 
上 的 视频 会 议和 即时 消息 提供 了 基础 。 


8.9 mem 


1. 如 何 使 用 HttpURLConnection 获取 网 络 上 的 一 张 图 片 并 将 其 显示 出 来 ? 

2. 如 何 使 用 Socket 通信 方式 实现 一 个 简单 的 对 等 聊天 软件 ? 

3. 在 PC 上 建立 一 个 聊天 室 ， 用 户 可 以 通过 手机 参与 到 该 聊天 室 ， 该 如 何 实现 ? 
4. 使 用 蓝牙 如 何 进行 文件 传输 ? 

5. 如 何 使 用 WIFI 对 周围 可 用 Peers 进行 搜索 并 建立 连接 ? 
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从 本 章节 可 以 学 习 到 : 
*^ 获取 位 置信 息 

* 使 用 Google 地 图 服务 
学 传感器 

学 运动 传感器 

o 位 置 传感器 

学 ”环境 传感器 
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位 置 服务 (LBS，Location Based Services) 又 称 定位 服务 ， 是 指 通过 GPS 卫星 或 者 蜂窝 
网 络 ， 获 取 各 种 终端 的 地 理 坐 标 〈 经 度 和 纬度 ) ， 在 电子 地 图 平台 的 支持 下 ， 为 用 户 提供 基 
于 位 置 导航 、 查 询 的 一 种 信息 业务 。 它 涉及 图 服务 、 计 算 机 应 用 互 操作 、 无 线 通信 、 智 能 终 
端 等 技术 。 实 质 上 是 一 种 概念 较为 宽泛 的 、 与 位 置 有 关 的 新 型 服务 业务 。 

LBS 系统 通过 移动 和 固定 网 络 发 送 基于 位 置 的 信息 与 服务 ， 使 得 这 种 服务 应 用 到 任何 
人 、 任 何 位 置 、 任 何 时 间 和 任何 设备 ， 这 就 是 LBS 的 优势 所 在 。 

GPS (Global Position System， 全 球 定位 系统 ) 是 20 世纪 70 年 代 由 美国 陆海空 三 军 联合 
研制 的 新 一 代 空间 卫星 导航 定位 系统 。 

由 于 卫星 的 位 置 精确 ， 在 GPS 观测 中 ， 我 们 可 以 得 到 卫星 到 接收 机 的 距离 ， 然 后 利用 三 
维 坐标 中 的 距离 公式 和 3 颗 卫星 就 可 以 组 成 3 个 方程 式 ， 解 出 观测 点 的 位 置 (X,YZ) 。 考 虑 
到 卫星 的 时 钟 与 接收 机 时 钟 之 间 的 误差 ， 实 际 上 有 4 个 未 知 数 ，X、Y、Z 和 时 钟 差 ， 然 后 用 
4 个 方程 将 这 4 个 未 知 数 解 出 来 ， 所 以 如 果 想 知道 接收 机 所 处 的 位 置 ， 至 少 要 能 接收 到 4 个 
卫星 的 信号 ， 从 而 得 到 观测 点 的 经 纬度 和 高 程 。 

2005 年 2 月 Google 推出 了 Google Maps， 该 服务 为 Google 的 搜索 服务 增加 了 影响 力 ， 
之 后 Google 也 将 GPS 应 用 放 在 了 Android 的 设备 中 。 

本 章节 我 们 将 学 习 在 Android 系统 下 如 何 使 用 相关 API 实现 位 置 服务 功能 。 


O | 获取 位 置信 息 


由 于 手机 设备 的 移动 性 ， 决 定 了 手机 在 位 置 服务 方面 拥有 比 固定 设备 更 多 的 优势 ， 可 以 
开发 多 种 基于 移动 设备 的 位 置 服务 应 用 程序 。 

Android SDK 提供 了 android.location 包 和 Google Maps API 支 持 位 置 服务 功能 ， 开 发 人 员 
可 以 方便 地 开发 自己 的 位 置 服务 应 用 程序 。Android 系统 支持 GPS 定位 方式 和 网 络 定位 方 
式 。GPS 方式 的 位 置信 息 来 自卫 星 ， 精 度 很 高 ， 但 是 GPS 方式 仅 在 户外 有 效 ， 其 首次 获取 位 
置 时 间 较 长 并 且 非 常 耗费 电量 ; 而 网 络 定位 方式 使 用 的 是 移动 通信 基站 和 WIFI 信号 ， 这 种 
方式 在 室内 和 户外 都 可 以 使 用 ， 响 应 快速 ， 费 电 较 少 ,但 是 精度 难以 保证 。 开 发 者 应 该 根据 
应 用 程序 的 使 用 环境 来 确定 具体 的 定位 方式 。 


9.1.1 LocationManager 介绍 


在 Android 的 位 置 服务 中 ，LocationManager 是 一 个 非常 重要 的 类 ， 它 位 于 android. 
location 包 中 。LocationManager 类 用 于 管理 Android 用 户 位 置 服务 信息 ， 提 供 确定 用 户 位 置 
的 API， 通 过 这 个 类 可 以 实现 定位 、 跟 踪 和 目标 趋 近 等 功能 。 

LocationManager 对 象 不 能 直接 实例 化 ， 可 以 通过 Context.getSystemService ( Context. 
LOCATION_SERVICE) 方法 获得 。 
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LocationManager 对 象 可 以 完成 以 下 三 个 方面 的 任务 : 
e 从 用 户 的 位 置 查询 所 有 可 用 的 LocationProvider 列表 
e 从 特定 的 LocationProvider 周期 性 获取 用 户 当 前 位 置 的 功能 
@” 当 用 户 位 置 接近 某 个 特定 区 域 时 ， 启 动 相关 任务 
K 9.1 为 LocationManager 类 的 常用 方法 。 
表 9.1 LocationManager 类 的 常用 方法 
常用 方法 方法 描述 
getAllProviders() 获得 所 有 LocationProvider 列表 


根据 Criteria 返回 最 合适 的 LocationProvider， 其 
中 criteria 指定 了 一 系列 条 件 


getLastKnownLocation (String provider) 根据 Provider 获得 最 新 位 置信 息 
getProvider (String name) 获得 指定 名 称 的 LocationProvider 
getProviders (boolean enabledOnly) 获得 可 用 的 LocationProvider 列表 


ddProximityAlert ( double latitude, double longitude, | , — * 
iu RA ute BoE HE 
float radius, long expiration, PendingIntent intent) 


removeProximityAlert ( PendingIntent intent) 删除 趋 近 警告 


9.1.2 ”LocationProvider 介绍 


getBestProvider (Criteria criteria,Boolean enabldOny) 


LocationProvider 为 位 置 提供 者 的 抽象 类 ， 位 置 提供 者 提供 手机 设备 的 周期 性 的 地 理 位 置 


LocationProvider 的 常用 方法 如 表 9.2 所 示 。 


表 9.2 LocationProvider 的 常用 方法 


常用 方法 方法 描述 

getAccuracy() 获取 LocationProvider 提供 位 置信 息 的 精度 
getName() 获得 LocationProvider 的 名 称 
getPowerRequirement() 获得 LocationProvider 对 电源 的 需求 
hasMonetaryCost() 获取 当前 LocationProvider 是 免费 的 还 是 收费 的 


确定 当前 LocationProvider 是 否 符合 特定 条 件 


meetsCriteria (Criteria criteria) 


requiresCell() LocationProvider 定位 是 否 需要 访问 基站 网 络 
requiresNetwork() LocationProvider 定位 是 否 需 要 Internet 网 络 数据 
requiresSatellite() LocationProvider 定位 是 否 需 要 获取 卫星 数据 
supportsAltitude() LocationProvider 提供 的 位 置信 息 是 否 包含 高 度 信息 
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( 续 表 ) 
常用 方法 方法 描述 
supportsBearing() 是 否 能 够 提供 方向 信息 
supportsA Ititude() LocationProvider 是 否 能 够 提供 速度 信息 


根据 设备 的 不 同 可 以 使 用 不 同 的 定位 技术 来 实现 位 置 服务 ， 也 就 是 获取 不 同 的 
LocationProvider， 以 下 是 3 种 获取 LocationProvider 实例 的 方法 。 


e 通过 指定 名 称 获 取 。 根 据 LocationManager 中 的 静态 常量 GPS PROVIDER 和 
NETWORK PROVIDER 来 分 别 获 得 GPS Provider 和 Network Provider。 例 如 : 


LocationManager manager= (LocationManager) getSystemService 
(Context.LOCATION SERVICE) ; 

// 指 定 Provider 名 称 为 LocationManager.GPS PROVIDER 

LocationProvider MyProvider-manager.getProvider 
(LocationManager.GPS PROVIDER) ; 


© 获取 可 使 用 的 LocationProvider 实例 列表 。 通 过 调用 locationManager.getProviders 
(true) 方法 就 可 以 获得 可 利用 的 LocationProvider 实例 列表 ， 例 如 : 


oolean enabledOnly=true; 


// 获 取 到 Provider 的 集合 

List<String>providers=locationManager.getProviders (enabledOnly) ; 

o 根据 Criteria 获取 符合 条 件 的 LocationProvider 3:45]. ÆA LocationProvider 都 有 一 个 
条 件 集合 ， 以 便于 应 用 程序 可 以 选择 合适 的 位 置 提供 者 。 例 如 有 的 LocationProvider 
要 求 设备 本 身 具 有 GPS 模块 ， 并 且 要 求 看 见 卫星 的 数量 ， 有 的 要 求 手 机 设备 能 够 接 
A Internet 或 者 特定 网 络 等 。Criteria 类 被 用 于 为 LocationProvider 设 置 相关 条 件 。 


Criteria 对 象 封 装 了 获得 LocationProvider 实例 的 条 件 ， 可 以 根据 指定 的 Criteria 条 件 来 过 
滤 LocationProvider 列表 以 得 到 符合 条 件 的 的 LocationProvider 实例 。 
Criteria 的 常用 方法 如 表 9.3 所 示 。 
#93 Criteria 的 常用 方法 


常用 方法 

isAltitudeRequired() 返回 Provider 是 否 需 要 高 度 信息 
isBearingRequired() 返回 Provider 是 否 需要 方向 信息 
isSpeedRequired() 返回 Provider 是 否 需要 速度 信息 
isCostAllowed() 标识 是 否 允 许 产 生 费 用 
setAccuracy (intaccuracy) 设置 Provider 的 精确 度 
setAltitudeRequired (boolean altitudeRequired) 设置 Provider 是 否 需 要 高 度 信息 
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(SER) 
常用 方法 方法 描述 
setBearingRequired (boolean bearingRequired) 设置 Provider 是 否 需 要 方位 信息 
setSpeedRequired (boolean speedRequired) 设置 Provider 是 否 需要 速度 信息 


setCostAllowed (boolean costAllowed ) 设置 是 否 需要 产生 费用 


getAccuracy() 获取 位 置信 息 的 准确 度 


下 面 的 代码 使 用 Criteria 对 象 创建 了 一 个 条 件 集 ， 并 根据 该 条 件 集 查找 到 合适 的 
LocationProvider 对 象 ， 并 从 该 LocationProvider 对 象 获取 到 了 位 置信 息 。 


// 获 取 Criteria H% 
Criteria criteria-new Criteria(); 


// 设 置 需要 更 精细 的 定位 精度 要 求 

criteria.setAccuracy (Criteria.ACCURACY FINE) ; 
// 设 置 定位 不 需要 高 度 信息 
criteria.setAltitudeRequired (false) ; 


// 设 置 不 需要 提供 轴承 信息 


criteria.setBearingRequired (false) ; 


// 设 置 允许 是 收费 


criteria.setCostAllowed (true) ; 


// 设 置 低 耗 能 

criteria.setPowerRequirement (Criteria.POWER LOW) ; 

// 根 据 设置 的 条 件 获 取 合 适 的 provider 

String provider-locationManager.getBestProvider 
(criteria,true) ; 

// 得 到 Location 对 象 

Location location-locationManager.getLastKnownLocation 
(provider) ; 


© LocationListener。 提 供 定位 信息 发 生 改 变 时 的 回调 功能 ， 此 接口 提供 了 4 个 常用 方 
法 ， 如 表 9.4 所 示 。 


表 9.4 LocationListener 的 常用 方法 


常用 方法 方法 描述 
onLocationChanged 当 坐 标 改变 时 触发 此 方法 ， 如 果 Provider 传 进 相同 的 坐标 ， 它 
(Location location) 就 不 会 被 触发 


onProviderDisabled (String provider) Provider 禁用 时 触发 此 方法 ， 例 如 ，GPS 被 关闭 时 
onProviderEnabled (String provider) Provider 启用 时 触发 此 方法 ， 例 如 ，GPS 被 打开 时 


Provider 的 状态 在 可 用 AVAILABLE 、 暂 时 不 可 用 
TEMPORARILY_UNAVAILABLE 和 无 服务 OUT_OF_SERVICE 
三 个 状态 直接 切换 时 触发 此 函数 


onStatusChanged ( String provider.int 
status,Bundle extras ) 
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在 本 章 后 面 的 实例 中 ， 会 使 用 到 该 接口 。 


9.1.3 ”使 用 GPS 获取 当前 位 置信 息 


要 获取 精确 的 位 置 服务 信息 需要 GPS 硬件 的 支持 。 在 应 用 程序 开发 阶段 ， 由 于 模拟 器 中 
并 没有 真正 的 GPS 硬件 ， 因 此 不 能 获得 真实 的 GPS 信息 。 但 是 可 以 使 用 Eclipse 视图 模式 的 
DDMS 模式 模拟 GPS 服务 ， 在 如 图 9.1 所 示 的 Emulator Control 界面 中 手动 发 送 经 纬度 信息 
来 测试 位 置 服务 。 


Emulator Control 23 


Location Controls 


| Manual (GPX | KML 


© Decimal 


| © Sexagesimal 
| Longitude 1234 
latitude — 418 


图 9.1 Emulator Control 界面 
获取 用 户 当前 位 置 ， 需 要 实现 以 下 四 个 基本 步骤 : 
G80) 在 AndroidManifestxml 文件 中 声明 相应 的 权限 。 

使 用 GPS_PROVIDER 定位 服务 需要 以 下 权限 : 


<uses-permission 
android:name="android.permission.ACCESS FINE_LOCATION"/> 


fH] NETWORK PROVIDER 定位 服务 需要 以 下 权限 : 


<uses-permission 
android:name-"android.permission.ACCESS COARSE LOCATION"/» 


€X302 获取 LocationManager 对 象 。 
€X308 选择 合适 LocationProvider。 
人 4 通过 LocationListener 接口 获取 位 置信 息 。 


实例 GPSLocationDemo 演示 了 使 用 GPS 获取 用 户 信 息 的 过 程 ， 运 行 效 果 如 图 9.2 所 示 。 
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D 


[el GPSLocation 


获取 GPS 信息 


度 为 : 123.4 
y : 41.79999833333333 


图 9.2 实例 GPSLocationDemo 运行 效果 
该 运行 效果 所 对 应 的 布局 文件 main.xml 内 容 如 下 : 


<?xml version-"1.0" encoding-"utf-8"?» 
«LinearLayout 
xmlns:android-"http://schemas.android.com/apk/res/android" 
android:orientation- "vertical" 
android:layout width-"fill parent" 
android:layout height-"fill parent" 
> 
<TextView 
android: layout_width="fill_ parent" 
android:layout height-"wrap content" 
android:text-"Gstring/hello" 
/> 
<Button 
android: id="@+id/btn_listen" 
android: layout_width="fill_ parent" 
android:layout height-"wrap content" 
android:text-"estring/btn listen" 
/» 
«TextView 
android: id="@+id/tv_01" 
android:layout width-"fill parent" 
android:layout height-"wrap content" 
android:text-"" 
/> 
<TextView 
android:id="@+id/tv_02" 
android:layout_width="fill_parent" 
android:layout height-"wrap content" 
android:text-"" 
/> 


</LinearLayout> 


该 布局 文件 所 使 用 的 资源 文件 strings.xml 文件 内 容 如 下 : 
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<?xml version-"1.0" encoding-"utf-8"?» 

«resources» 
«string name="hello">{#}f] GPS 获取 位 置信 息 </string> 
«string name="app name">GPSLocation</string> 
«string name-"btn 1isten"> 获 取 GPS 信息 </string> 

</resources> 


实例 GPSLocationDemo 中 的 主 Activity 文件 GPSLocationActivity java 代码 如 下 : 


package introduction.android.gpsLocation; 


import android.app.Activity; 

import android.content.Context; 

import android.location.Location; 

import android.location.LocationListener; 
import android.location.LocationManager; 
import android.os.Bundle; 

import android.util.Log; 

import android.view. View; 

import android.view.View.OnClickListener; 
import android.widget.Button; 

import android.widget.TextView; 


public class GPSLocationActivity extends Activity { 
/** Called when the activity is first created. */ 
private Button btn_listen; 
private TextView tv_01,tv_02; 


GOverride 

public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState) ; 
setContentView (R.layout.main) ; 


btn listen- (Button) findViewById (R.id.btn listen) ; 
tv O1- (TextView) findViewById (R.id.tv 01) ; 
tv 02- (TextView) findViewById (R.id.tv 02) ; 


btn listen.setOnClickListener (new OnClickListener () { 


@Override 
public void onClick (View v) { 
LocationManager locationManager= 
(LocationManager) GPSLocationActivity.this.getSystemService 
(Context.LOCATION SERVICE) ; 
locationManager.requestLocationUpdates 
(LocationManager.GPS PROVIDER, 0, 0,new MyLocationListener()) ; 


} 
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class MyLocationListener implements LocationListener{ 


@Override 
public void onLocationChanged (Location location) { 
// TODO Auto-generated method stub 


tv_0l.setText ("您 当前 位 置 的 经 度 为 : 
"+location.getLongitude()) ; 


tv 02.setText ("您 当前 位 置 的 纬度 为 : 
"+location.getLatitude()) ; 


} 


GOverride 

public void onProviderDisabled (String provider) { 
/ [4 provider 被 用 户 关闭 时 调用 
Log.i ("GpsLocation", "provider 被 关闭 ! ") ; 


} 


GOverride 
public void onProviderEnabled (String provider) { 


//% provider 被 用 户 开启 后 调用 
Log.i ("GpsLocation", "provider 被 开启 ! ") ; 


} 


GOverride 


public void onStatusChanged (String provider, int status, 
Bundle extras) { 


// provider 的 状态 在 OUT OF SERVICE, 
TEMPORARILY UNAVAILABLE 和 AVAILABLE 之 间 发 生变 化 时 调用 


Log.i ("GpsLocation", "provider 状态 发 生 改变 ! ") ; 
} 


} 

由 以 上 代码 可 见 ， 借 助 于 Android SDK 提供 的 位 置 服务 API， 仅 仅 几 行 代码 就 可 以 实现 
使 用 GPS 定位 的 功能 。 

LocationListener 用 于 接收 位 置 发 生 改 变 时 的 通知 。 当 Provider 提供 的 位 置信 息 发 生 改 变 


时 ，onLocationChanged() 方 法 会 被 调用 。 当 不 需要 使 用 LocationListener 进行 位 置 更 新 时 ， 可 
以 通过 LocationManager.removeUpdates (locationListener) 方法 将 其 移 除 。 


395 


Android 4.X 从 入 门 到 精通 


9 。 2 使 用 Google 地 图 服务 


9.2.1 Google Map API 简介 


Google Map 是 Google 公司 提供 的 电子 地 图 服务 ， 它 能 提供 三 种 视图 ， 分 别 是 矢量 地 图 
(传统 地 图 ) 、 俯 视 地 图 、 地 形 地 图 。 矢 量 地 图 可 以 提供 政 区 和 交通 以 及 商业 信息 ;俯视 地 图 
可 以 提供 不 同 分 辨 率 的 卫星 照片 ;地形 地 图 可 以 用 于 显示 地 形 和 等 高 线 。 

2006 年 ，Google 发 布 了 一 个 基于 Java 的 应 用 程序 称 为 Google Maps for Mobile， 可 以 用 
在 Java-based 的 手机 上 ， 支 持 Symbian、Windows Mobile 等 移动 平台 。 在 Android 系统 推出 
后 ，Google Map 服务 得 到 了 更 好 的 发 展 。 

2010 年 11 月 30 H, Google 宣布 ， 正 式 推 出 最 新 版 地 图 服务 “Google Earth 6”， 新 版 
整合 了 街景 和 3D 技术 ， 可 为 用 户 提供 逼真 的 浏览 体验 。 新 版 本 支持 Windows, OS X 和 
Linux 操作 系统 。 

Android 版 本 的 Google Map 服务 在 其 基本 服务 的 基础 上 近期 又 追加 集成 Google Offers Hk 
4: 对 Google Business Photos (企业 照片 ) 服务 提供 支持 ;支持 室内 步行 导航 、 自 动 搜寻 附 
近 餐 厅 、 酒 吧 、 加 油 站 等 详细 资料 的 功能 。 

Google Map API 是 Google 自己 推出 的 编程 API， 可 以 让 全 世界 对 Google Map 有 兴趣 的 
程序 设计 人 员 自 行 开 发 基于 Google Map 的 服务 ， 建 立 自己 的 地 图 应 用 程序 。 

通过 Google Map 为 开发 者 提供 的 地 图 API， 可 以 开发 出 各 种 各 样 有 趣 的 地 图 Mash-up 应 
用 ， 还 可 以 将 不 同 地 图 图 层 加 载 到 应 用 中 ， 如 卫星 影像 、 根 据 海拔 高 度 绘制 的 高 山 和 植被 地 
形 图 、 街 道 视图 等 ， 从 而 帮助 开发 者 打造 个 性 化 的 地 图 应 用 站 点 。 

Google 地 图 API 是 一 种 通过 JavaScript 将 Google 地 图 嵌入 到 网 页 的 API。 该 API 提供 了 
大 量 实用 工具 用 以 处 理 地 图 ， 并 通过 各 种 服务 向 地 图 添加 内 容 ， 从 而 使 您 能 够 在 您 的 网 站 上 
创建 功能 全 面 的 地 图 应 用 程序 。 

Google Map API 定义 了 一 系列 的 用 于 在 Google Map 上 显示 、 控 制 和 层 登 信息 的 功能 
类 ， 放 和 置 在 名 为 com.google.android.maps 的 包 中 。Google Map API 不 属于 Android SDK 的 标 
准 库 组 件 ， 需 要 单独 下 载 。 

下 面 介绍 几 个 常用 的 类 和 接口 : 


* MapView。 用 于 显示 地 图 的 View 组 件 ， 它 派生 自 android.view.ViewGroup。 使 用 这 个 
组 件 的 时 候 必须 和 MapActivity 配合 使 用 ，MapView 需要 由 MapActivity 来 管理 。 
MapView 提供 了 3 种 模式 的 地 图 ， 分 别 为 交通 模式 、 卫 星 模 式 、 街 景 模式 ， 分 别 可 以 
通过 以 下 方式 设置 采用 什么 模式 来 显示 地 图 ， 代 码 如 下 : 


MapView map-new MapView (this,"Android Maps API Key") ;// 得 到 MapView 对 象 
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map.setTraffic (true) ;// 设 置 为 交通 模式 
map.setSatellite (true) ;// 设 置 为 卫星 模式 
map.setStreetView (true) ;// 设 置 为 街景 模式 


* MapActivity。 用 于 显示 Google Map 的 Activity 类 ， 它 是 一 个 抽象 类 ， 任 何 想 要 显示 
MapView 的 Activity 都 需要 派生 自 MapActivity， 并 且 在 其 派生 类 的 onCreate() 中 要 创 
建 一 个 MapView 实例 。 

© MapControllr, 。 用 于 控制 地 图 的 移动 、 缩 放 等 操作 。 可 以 通过 以 下 代码 获得 
MapController: 


MapController mapController=map.getController() ; 


© Overlay。 用 于 显示 地 图 之 上 的 可 绘制 的 对 象 ， 例 如 ， 显 示 地 点 图 标 。 

© GeoPoint。 包 含 经 纬度 位 置 的 对 象 ， 它 可 以 实现 地 点 定位 。 要 想 实现 一 个 简单 的 地 点 
定位 ， 首 先 ， 需 要 构建 一 个 GeoPoint 来 表示 地 点 的 经 度 和 纬度 ， 然 后 使 用 animateTo 
方法 将 地 图 定位 到 GeoPoint 代表 的 经 纬度 的 地 点 。 例 如 : 

GeoPoint geoPonit=new GeoPoint ( (int) (12.5*1000000) , (int) 


(122.6*1000000) ) ; 
mapController.animateTo (geoPonit) ; 


9.2.2 Aig Android Map API Key 


要 使 用 Google Map 提供 的 地 图 服务 数据 ， 必 须要 申请 一 个 Android Map API Key. fH 
请 Android Map API Key 之 前 必须 要 准备 Google 的 帐号 和 给 应 用 程序 签名 的 证 书 。 如 果 没 有 
Google 帐号 可 以 到 http://www.google.com/ 申 请 一 个 。Android 应 用 程序 发 布 时 必须 使 用 证 书 
进行 签名 。 在 之 前 的 开发 过 程 中 ， 虽 然 一 直 没有 涉及 证 书 的 问题 ， 但 是 实际 上 ， 我 们 一 直 在 
使 用 Android 开发 环境 提供 的 debug 版 本 的 证 书 来 签名 应 用 程序 。 在 调试 阶段 ， 所 有 的 应 用 
程序 都 是 使 用 预定 义 的 debug.keystore 中 的 androiddebugkey 来 签名 的 。 如 果 是 Windows XP 
系统 ， 该 文件 被 存放 在 Documents and Settings/<user>/Local Settings/Application Data/Android 
目录 下 ; 如 果 是 Windows 7 系统 ， 则 存放 在 user/<user>/.android 目录 下 。 

在 程序 调试 阶段 ， 可 以 使 用 Debug 版 的 证 书 申请 签名 密 钥 。 下 面 是 申请 Android Map 
API Key 的 具体 步骤 ; 


€E 找到 自己 的 debug.keystore 文 件 。 


运行 cmd 命令 ， 跳 转 到 debug.keystore 所 在 目录 。 笔 者 的 计算 机 是 Windows7 系统 ， 直 接 
输入 “cd .android”， 单 击 回 车 即 可 。 


€X302 获取 debug keystore 文件 的 MD5 值 。 
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继续 在 上 一 步 的 基础 上 输入 “keytool -list -keystore debug.keystore” 命 令 ， 单 击 回 
后 输入 keystore 密码 ， 默 认 密码 为 android， 然 后 单 击 回 车 键 ， 即 可 得 到 根据 调试 密 多 
MDS 认证 指纹 的 值 ， 如 图 9.3 所 示 。 该 MDS 认证 指纹 唯 


成 自己 的 MDS 认证 指纹 。 
Keytool.exe 是 Java JDK 提供 的 密 钥 工 具 ， 被 放置 在 <JDK 安装 目录 >/bin 目录 下 ， 需 要 将 
该 目录 设置 到 path 环境 变量 里 才能 在 cmd 窗口 中 直接 使 用 该 命名 。 参 数 -list 表示 在 cmd 窗口 
中 打印 生成 的 MDS 指纹 ，-keystore<kestore_name>.keystore 表示 证 书 所 在 的 keystore 文件 ， 

具体 操作 如 图 9.3 所 示 。 


€I: 


打开 浏览 器 ， 


-， 读 者 在 调试 程序 时 应 该 重新 生 


| 
T 


画 CA Windows system32Vcm: 


1 : B6 :8B:43:0D:67:FF 


图 9.3 获取 debug keystore [f] MDS {ff 


申请 Android Map API Key 


并 在 浏览 器 中 输入 以 下 网 址 : htps://developers.google.com/android/maps- 


api-signup?hl=zh-CN， 登 录 自 己 的 Google 帐号 ， 在 申请 页 面 选择 “I have read and agree with 
the terms and conditions” 选 项 ， 然 后 输入 步骤 2 得 到 的 MDS 认证 指纹 值 ， 单 击 Generate API 
Key 按钮 ， 页 面 跳 转 后 即 得 到 Android Map API Key， 如 图 9.4 所 示 。 
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Android Maps APIs Terms of Service 


Last Updated: October 13, 2008 


Thanks for your interest in the Android Maps APIs. The Android Maps 
APIs are a collection of services (including, but not limited to, the 
"com. google.android.maps.MapView" and "al id.location.Geocoder" 
Classes) that allow you to in ng, and other 

from Google and its cont 
The Android Maps APIs exp 
data or local search data 


1. Your relationship with Google. 
1.1. Your use of any of the Android Maps APIs (referred to in this 


7] I have read and agree with the terms and conditions (printable version) 
My certificate's MDS fingerprint: |09:A0:B3:24:F9-1F-AD-B9:0F-9A:B6:8B:43:0D:67-FF 
Generate API Key 


图 9.4 申请 Android Map API Key 页 面 


和 


生成 的 密 钥 信息 显示 如 图 9.5 所 示 ， 并 且 提供 了 使 用 MapView 的 示例 代码 ， 


第 9 章 “位置 服务 


将 该 代码 作为 一 个 组 件 复制 到 工程 中 的 布局 xml 文件 中 ， 就 可 以 直接 使 用 了 。 使 用 MapView 
组 件 必须 制定 apiKey 属性 ， 若 apiKey 不 能 与 签名 密 钥 匹配 ， 则 不 能 正常 显示 地 图 。 


5oogle 地 图 API 
|Google 主页 > Google 地 图 AP! > Google 地 图 API 注册 
Ant 
onena: 


OrvIRrEPTUYSUXACd_p53h-ftI7T425PT00jKUQ 


此 密 钼 适用 于 所 有 使 用 以 下 指纹 所 对 应 证 书 进行 验证 的 应 用 : 


09:A0:83:24:F9:1F:AD:B9:0F:9A:B6:8B:43:0D:67:FF 


下 面 是 一 个 xml 格式 的 示例 ， 帮 助 您 了 解 地 图 功能 : 


<com. google.android.maps.MapView 
android:layout_width="fill_parent" 
android:layout heighte"fill parent" 
android:apiKeye"OrvIRrEPTuYSUXACd pSSh-ft171425PTO0jKuQ" 
/> 


有 关 详 细 信息 ， 请 查看 API 文档 。 


图 9.5 MDS 生成 的 密 钥 信息 


9.2.3 ”使 用 Google Map 显示 当前 位 置 


下 面 通过 一 个 实例 完成 一 个 简单 的 定位 系统 ， 并 且 在 地 图 上 显示 当前 的 位 置 ， 实 例 详细 
代码 在 GPSLocationInMapDemo 项 目 中 ， 实 际 调试 时 需要 在 真 机 上 进行 并 且 需 要 开启 GPS. 
运行 效果 如 图 9.6 所 示 。 


P GPSLocationinMapDemo 


图 9.6 一 个 简单 的 定位 系统 
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具体 步骤 如 下 : 
ED 创建 一 个 新 的 工程 并 命名 为 GPSLocationInMapDemo ， 需 要 注意 的 是 由 于 要 使 用 
Google Map API， 所 以 创建 的 主 Activity 需要 继承 自 MapActivity ， 而 不 是 


Activity。 当 选择 Build Target 时 应 选择 Google APIs， 如 图 9.7 所 示 。 


(8 New Android Project 
| rps 
Gaon be 
m — me 
[E Ardoa að dio 40 o] 
expan: — [agat s 


Android + Google API« 


inish (jancels) 


rr | EE 


© Ere 
图 9.7 New Andriod Project 对 话 框 


人 2 & AndroidManifest.xml 文件 中 的 <application> 标 签 中 加 入 : 
<uses-library android:name="com.google.android.maps" /> 


以 便 可 以 使 用 Google Map API. y f fEH] GPS 数据 ， 在 <application> 标 签 之 外 加 入 如 下 


权限 : 


<uses-permission android:name="android.permission.ACCESS FINE LOCATION" 


/> 
为 了 从 Internet 获取 地 图 数据 ， 需 要 网 络 访问 权限 : 
<uses-permission android:name="android.permission.INTERNET"/> 


EIo 编写 main.xml 布局 文件 ， 具 体 代码 如 下 : 


<?xml version-"1.0" encoding-"utf-8"?» 


«LinearLayout 
android:layout width-"fill parent" 


android:layout height-"fill parent" 


xmlns:android- "http://schemas.android.com/apk/res/android" 
android:orientation-"vertical"» 


«TextView 
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android: layout_width="fill parent" 
android:layout height-"wrap content" 
android:text="@string/hello" /> 
<TextView 
android: id="@+id/myLocationText" 
android: layout_width="fill_ parent" 
android:layout height-"wrap content" 
/> 
<com.google .android.maps .MapView 
android: id="@+id/myMapView" 
android: layout_width="fill_ parent" 
android: layout_height="fill parent" 


HOS ”位 置 服务 


android: apikey="0rvIRrEPTuYsUXACd_p53h-ftI7T425PTo0jKuQ" 


android:clickable="true" /> 
</LinearLayout> 


在 main.xml 布局 中 放置 了 两 个 TextView 和 一 个 Map View 组 件 。 
GPSLocationInMapDemoActivity.java 代码 如 下 : 


package introduction.android.gpsLocationInMapDemo; 


import android.content.Context; 

import android.location.Location; 

import android.location.LocationListener; 
import android. location.LocationManager; 
import android.os.Bundle; 

import android.widget.TextView; 

import com.google.android.maps.GeoPoint; 
import com.google.android.maps.MapActivity; 
import com.google.android.maps.MapController; 
import com.google.android.maps.MapView; 
import com.google.android.maps.MyLocationOverlay; 


public class GPSLocationInMapDemoActivity extends MapActivity { 


/** Called when the activity is first created. */ 
// ÆX Location 对 象 

protected Location location; 

// 定义 MapView 对 象 

private MapView map; 

// XX MyLocationoverlay 对 象 ， 在 地 图 上 标注 当前 位 置 
private MyLocationOverlay myLocation; 

private MapController mapController; 

private TextView myLocationText; 

private GeoPoint geopoint; 

private double latitude; 

private double longitude; 
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/** Called when the activity is first created. */ 
protected boolean isRouteDisplayed() { 
return false; 


} 


public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState) ; 
setContentView (R.layout.main) ; 
myLocationText- (TextView) findViewById (R.id.myLocationText) ; 
// 定义 LocationManager 对 象 
LocationManager locationManager; 
String seviceName-Context.LOCATION SERVICE; 
// 获取 LocationManager 对 象 
locationManager= (LocationManager) getSystemService 
(seviceName) ; 
locationManager . requestLocationUpdates 
(LocationManager.GPS_PROVIDER, 
2000, 10, locationListener) ; 
// 得 到 MapView 对 象 
map= (MapView) findViewById (R.id.myMapView) ; 
// 得 到 MapView 对 象 的 控制 器 
mapController=map.getController() ; 
// 设置 map 支持 缩放 工具 条 
map.setBuiltInZoomControls (true) ; 
map.setSatellite (true) ; 


} 


// 得 到 LocationListener 对 象 
private final LocationListener locationListener=new 
LocationListener () { 


// *4 Provider 处 于 不 能 使 用 时 触发 
public void onProviderDisabled (String provider) { 


} 

// 当 状态 发 生 改 变 时 触发 

public void onStatusChanged (String provider, int status, 
Bundle extras) { 


} 


// 当 位 置 发 生变 化 时 触发 

Goverride 

public void onLocationChanged (Location location) { 
// TODO Auto-generated method stub 
// 得 到 当前 位 置 的 纬度 
latitude=location.getLatitude () ; 


// 得 到 当前 位 置 的 经 度 
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longitude=location.getLongitude() ; 


geopoint=new GeoPoint (new Double (latitude * 
1E6) .intValue(), 
new Double (longitude * 1E6) .intValue()) ; 


mapController.setCenter (geopoint) ; 

// 得 到 当前 位 置 的 MyLocationOverlay 对 象 

myLocation=new MyLocationOverlay ( 
GPSLocationInMapDemoActivity.this, map) ; 

myLocation.enableMyLocation () ; 

// 将 当前 位 置 添加 到 地 图 上 

map.getOverlays().add (myLocation) ; 

// 设置 地 图 为 卫星 模式 

myLocationText.setText ("当前 位 置 纬度 : "+latitude+"\n 当前 位 


BAR: " 
+longitude) ; 
} 
// *4 Provider 处 于 可 用 时 触发 
GOverride 
public void onProviderEnabled (String provider) { 
// TODO Auto-generated method stub 
} 
hi 
} 


该 实例 中 获取 GPS 经 纬度 数据 的 过 程 和 上 一 节 中 完全 相同 ， 在 此 不 再 描述 。MapView 组 
件 通 过 网 络 载 入 所 需 地 图 ， 并 且 提 供 了 拖 忠 地 图 的 接口 ， 用 户 可 以 直接 在 MapView 中 移动 地 
Fel. MapView 提供 了 地 图 控制 器 ， 通 过 


mapController=map.getController () ; 


方法 可 以 获取 到 。 通 过 控制 器 可 以 方便 地 控制 Map View 组 件 中 地 图 的 缩放 和 窗口 移动 。 
本 实例 中 通过 


mapController.setCenter (geopoint) 


控制 器 将 当前 位 置 geopoint 设置 为 MapView 组 件 的 中 心 。GeoPoint 代表 的 是 地 图 上 特定 
的 点 ， 需 要 注意 的 是 在 MapView 中 使 用 的 geoPoint 的 经 纬度 位 置 与 从 GPS 中 获取 到 的 经 纬 
度 存在 一 个 1E6 的 比例 差 ， 需 要 经 过 转换 后 才能 正确 显示 当前 位 置 。 本 实例 中 的 坐标 转换 代 
码 为 : 

latitude-location.getLatitude(); 

longitude=location.getLongitude() ; 


geopoint-new GeoPoint (new Double (latitude * 1E6) .intValue(), 
new Double (longitude * 1E6) .intValue()) ; 
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MapView 提供 了 更 加 方便 的 对 地 图 数据 进行 缩放 的 方式 ， 通 过 


map.setBuiltInZoomControls (true) ; 


在 地 图 上 放置 一 个 缩放 条 〔 如 图 9.8 所 示 ) ， 用 户 可 以 直接 使 用 该 缩放 条 对 地 图 进行 放 
大 和 缩小 ， 而 无 需 编写 任何 代码 。 


Overlay 是 Google Map API 提 供 的 专门 在 地 图 上 进行 标记 的 类 。 本 实例 中 使 用 Overlay bx 
记 当 前 的 位 置 点 。 相 关 代码 为 : 
// 得 到 当前 位 置 的 MyLocationOverlay 对 象 
myLocation=new MyLocationOverlay ( 
GPSLocationInMapDemoActivity.this, map) ; 


myLocation.enableMyLocation(); 


// 将 当前 位 置 添加 到 地 图 上 
map.getOverlays().add (myLocation) ; 


至 此 ， 该 实例 开发 完成 。 运 行 该 实例 需要 支持 Google APIs 的 AVD, WE 9.9 fra. d 
没有 可 以 通过 AVD Manager 创建 一 个 。 
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Android 传感器 简介 


大 部 分 的 Android 设备 都 带 有 内 建 的 用 于 测量 运动 、 方 位 以 及 各 种 环境 条 件 的 传感器 。 
这 些 传感器 能 够 提供 高 精度 、 高 准确 性 的 原始 数据 ， 当 用 户 需要 监控 设备 的 三 维 运动 和 位 置 
或 者 监控 周围 条 件 的 变换 时 ， 这 些 传感器 很 有 效 。 举 例 来 讲 ， 
备 的 重力 传感器 的 方式 推断 用 户 的 动作 和 运动 ， 如 倾斜 、 摇 冕 、 旋 转 、 摆 动 等 ， 一 个 天 气相 
关 的 应 用 程序 可 以 通过 设备 的 温度 传感器 和 湿度 传感器 计算 并 报告 露水 情况 ; 一 个 旅游 相关 
的 应 用 程序 可 以 根据 地 磁 传 感 器 和 加 速 传感器 模拟 一 个 罗盘 。 
总 的 来 讲 ，Android 平 台 支 持 三 种 类 型 的 传感器 : 


Name: — GMapDevice 


Target [Google APIs (Google Inc) - API Level 14. z) 


CPU/ABI: [ARM (armeabi-v7a) 
SD Card: 


@ size 10 区 本 


D File: Browse 


Snapshot 
四 Enabled 


© Resolution: x 


Hardware: 


Property Value [New] 
Abstracted LCD density 160 
Max VM application h... 24 

Device ram size 256 


Override the existing AVD with the same name 


Ciano) Eee | 


{© Edit Android Virtual Device (AVD) ==) 


9.9 创建 支持 Google APIs 的 AVD 
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一 个 游戏 可 以 通过 不 断 读 取 设 


运动 传感器 Motion Sensors: 这 种 类 型 的 传感器 用 于 在 三 维 方向 测量 加 速 力 和 旋转 
力 ， 包 括 加 速度 传感器 、 重 力 传感器 、 陀 螺 仪 和 旋转 向 量 传感器 等 。 

环境 传感器 Environmental Sensors: 这 种 类 型 的 传感器 测量 各 种 环境 参量 ， 如 环境 温 
度 、 气 压 和 湿度 等 ， 包 括 气 压 计 、 光 度 计 和 温度 计 等 。 
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e 位 置 传感器 Position Sensors; 这 种 类 型 的 传感器 用 于 测量 设备 的 物理 位 置 ， 包 括 方向 
传感器 和 磁力 计 等 。 


开发 者 可 以 访问 设备 上 支持 的 传感器 ， 并 且 通 过 Android 传感器 框架 获取 相关 的 原始 数 
据 。Android 传感器 框架 提供 几 个 类 和 接口 帮助 开发 者 开发 完成 与 传感器 相关 的 各 种 任务 。 
例如 ， 可 以 使 用 传感器 框架 完成 如 下 任务 : 


© 获取 当前 设备 支持 的 传感器 类 型 。 

e 获取 某 个 传感器 的 具体 信息 ， 例 如 最 大 范围 、 生 产 商 、 功 耗 和 分 辩 率 等 。 
e 从 传感器 获取 原始 信息 以 及 换取 信息 的 频率 。 

© 注册 或 者 注销 用 于 监测 传感器 变化 的 监听 器 。 


Android 的 传感器 框架 允许 开发 者 访问 当前 设备 上 各 种 类 型 的 传感器 ， 包 括 硬件 传感器 
和 软件 传感器 。 硬 件 传感器 指 内 建 在 Android 设备 中 的 硬件 部 分 ， 它 们 直接 测量 具体 数据 并 
传递 给 应 用 程序 。 软 件 传感器 不 是 以 硬件 方式 存在 于 设备 中 ， 而 是 软件 模拟 出 来 的 ， 因 此 又 
叫 虚拟 传感器 或 者 合成 传感器 。 它 们 的 数据 来 自 一 个 或 者 多 个 硬件 传感器 。 线 性 加 速度 传 感 
器 和 重力 传感器 是 典型 的 软件 传感器 。 

K 9.5 为 Android 平 台 支 持 的 所 有 的 传感器 类 型 。 
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#95 Android 平台 支持 的 传感器 类 型 


传感器 类 型 用 途 
TYPE_ACCELEROMETER 硬件 传感器 运动 探测 
TYPE AMBIENT TEMPERATURE 硬件 传感器 监控 环境 温度 
TYPE_GRAVITY 软件 或 者 硬件 传感器 运动 探测 
TYPE_GYROSCOPE 旋转 探测 


TYPE_LIGHT 硬件 传感器 控制 屏幕 亮度 


TYPE_LINEAR_ACCELERATION 软件 或 者 硬件 传感器 探测 某 个 方向 的 加 速度 


TYPE MAGNETIC FIELD 硬件 传感器 创建 罗盘 


TYPE_ORIENTATION 探测 设备 方位 

TYPE PRESSURE 探测 空气 压力 变化 

TYPE PROXIMITY 用 于 监测 打 电 话 时 手机 与 耳 杀 的 距离 
TYPE_RELATIVE_HUMIDITY 探测 结 露 点 、 相 对 和 绝对 湿度 
TYPE_ROTATION_VECTOR 运动 检测 和 旋转 检测 


TYPE_TEMPERATURE 硬件 传感器 探测 温度 


以 上 传感器 类 型 在 Android 4.0 (API Level 14) 系统 中 都 获得 了 支持 ， 但 是 TYPE_ 
ORIENTATION 和 TYPE TEMPERATURE 两 种 类 型 已 经 被 弃 用 。 

如 果 应 用 程序 要 被 发 布 在 Google Play 上 ， 则 可 以 通过 应 用 程序 的 Manifest 配置 文件 中 
<uses=features> 属 性 来 设置 应 用 程序 的 发 布 对 象 。 例 如 下 列 代码 : 


<uses-feature android:name="android.hardware.sensor.accelerometer" 
android:required="true" /> 


可 以 保证 应 用 程序 只 能 被 带 有 加 速度 传感器 的 手机 设备 搜索 到 。 
Android 传感器 框架 存放 在 android hardware 包 中 ， 主 要 涉及 以 下 几 个 类 和 接口 : 


© SensorManager: 这 个 类 被 用 于 创建 传感器 服务 实例 。 该 类 提供 了 访问 和 罗列 传感器 
的 各 种 方法 ， 用 于 注册 和 注销 传感器 事件 监听 器 并 获取 方向 信息 。 该 类 也 提供 了 几 个 
常量 ， 用 于 报告 传感器 的 精度 、 数 据 获取 率 和 校正 传感器 。 

© Sensor 这 个 类 被 用 作 创 建 某 个 特定 传感器 的 实例 。 该 类 提供 了 用 于 确定 传感器 能 力 
的 各 种 方法 。 

* SensorEvent: 该 类 被 用 作 创建 传感器 事件 对 象 。 传 感 器 事件 对 象 包含 了 传感器 事件 的 
相关 信息 ， 包 括 原始 的 传感器 数据 、 传 感 器 类 型 、 产 生 的 事件 、 事 件 精度 以 及 事件 发 
生 的 时 间 玲 等 。 

© SensorEventListener: 该 接口 包含 了 两 个 回调 方法 。 当 传感器 的 值 发 生 改 变 或 者 传 感 
器 的 精度 发 生 改 变 ， 相 关 方 法 就 会 被 自动 调用 。 
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通过 传感器 框架 API， 开 发 者 主要 可 以 完成 两 件 事 : 
识别 传感器 并 且 明 确 传 感 器 功能 。 


只 
we 


监听 传感器 事件 并 进行 处 理 。 


9.3.2 ”标识 传感器 


识别 传感器 的 工作 要 通过 SensorManager 类 的 实例 来 完成 。 获 取 SensorManager 实例 的 代 
码 如 下 : 


private SensorManager mSensorManager; 


mSensorManager= (SensorManager) getSystemService 
(Context.SENSOR SERVICE) ; 


通过 SensorManager 获取 当前 设备 的 传感器 列表 的 代码 如 下 : 


List«Sensor»deviceSensors-mSensorManager.getSensorList 
(Sensor.TYPE ALL) ; 


要 获取 特定 类 型 的 传感器 实例 使 用 SensorManagergetDefaultSensor() 方 法 。 下 列 代码 演示 
了 获取 磁场 传感器 的 的 方法 : 


if (mSensorManager.getDefaultSensor 
(Sensor.TYPE MAGNETIC FIELD) !-null) { 


// Success! There's a magnetometer. 


} 


else { 
// Failure! No magnetometer. 


} 
下 列 示例 代码 演示 了 获取 当前 设备 的 重力 传感器 的 过 程 。 要 求 重 力 传感器 的 销售 商 是 
“Google Inc.”， 如 果 满 足 该 条 件 的 传感器 不 存在 ， 则 尝试 使 用 加 速度 传感器 : 


private SensorManager mSensorManager; 
private Sensor mSensor; 


mSensorManager- (SensorManager) getSystemService 
(Context.SENSOR SERVICE) ; 


if (mSensorManager.getDefaultSensor (Sensor.TYPE GRAVITY) !-null) { 
List<Sensor>gravSensors=mSensorManager .getSensorList 


(Sensor. TYPE_GRAVITY) ; 
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for (int i=0; i<gravSensors.size(); i++) { 


if ( (gravSensors.get (i) .getVendor().contains ("Google Inc.") ) && 
(gravSensors.get (i) .getVersion()==3) ) { 
// Use the version 3 gravity sensor. 
mSensor=gravSensors.get (i) ; 


} 
) 
} 


else{ 
// Use the accelerometer. 
if (mSensorManager .getDefaultSensor 
(Sensor. TYPE_ACCELEROMETER) !=null) { 
mSensor-mSensorManager.getDefaultSensor 
(Sensor.TYPE ACCELEROMETER) ; 
} 
else{ 
// Sorry, there are no accelerometers on your device. 
// You can't play this game. 


) 
) 


9.8.3 ”传感器 事件 处 理 

传感器 事件 监听 器 接口 提供 两 个 方法 : onAccuracyChanged0 和 onSensorChanged() 方 法 ， 
分 别 对 传感器 的 精度 改变 和 传感器 的 数值 改变 事件 进行 处 理 。 

下 列 代码 演示 了 从 光敏 传感器 获取 数据 的 过 程 : 


public class SensorActivity extends Activity implements 
SensorEventListener { 
private SensorManager mSensorManager; 
private Sensor mLight; 


GOverride 

public final void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState) ; 
setContentView (R.layout.main) ; 


mSensorManager- (SensorManager) getSystemService 
(Context.SENSOR SERVICE) ; 
mLight-mSensorManager.getDefaultSensor (Sensor.TYPE LIGHT) ; 


) 


@Override 
public final void onAccuracyChanged (Sensor sensor, int accuracy) { 
// Do something here if sensor accuracy changes. 
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} 


@Override 

public final void onSensorChanged (SensorEvent event) { 
// The light sensor returns a single value. 
// Many sensors return 3 values, one for each axis. 
float lux=event.values [0]; 
// Do something with this sensor value. 


} 


Goverride 
protected void onResume() { 
super .onResume () ; 
mSensorManager.registerListener (this, mLight, 
SensorManager.SENSOR DELAY NORMAL) ; 


) 


Goverride 

protected void onPause() { 
super .onPause() ; 
mSensorManager.unregisterListener (this) ; 


} 
} 


其 中 ， 


GOverride 
protected void onPause() { 
super.onPause(); 
mSensorManager.unregisterListener (this) ; 


) 


这 几 行 代码 是 很 有 必要 的 。 如 果 当 Activity 暂停 的 时 候 传 感 器 的 事件 监听 器 没有 被 注 
销 ， 则 该 监听 器 还 会 一 直 从 传感器 获取 信息 ， 这 样 会 耗费 大 量 的 电力 。 因 此 当 Activity 暂停 
时 ， 一 定 要 使 用 上 述 代码 在 onPause() 方 法 中 注销 对 传感器 事件 的 监听 。 当 Activity 再 次 被 激 
活 时 ， 在 onResume() 方 法 中 使 用 SensorManagerregisterListener() 方 法 重新 注册 传感器 事件 监 
Wr es 
mSensorManager.registerListener (this, mLight, 
SensorManager.SENSOR DELAY NORMAL) ; 


表示 注册 的 传感器 事件 监听 器 为 当前 类 的 实例 ， 被 监听 的 传感器 为 mLight， 获 取 数 据 的 
频率 为 SENSOR_DELAY_NORMAL. 
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运动 传感器 


目前 Android 平台 支持 的 运动 传感器 包括 以 下 五 种 : 


TYPE_ACCELEROMETER. 
TYPE GRAVITY, 

TYPE GYROSCOPE, 

TYPE LINEAR ACCELERATION. 
TYPE ROTATION VECTOR. 


本 章节 将 对 这 几 种 传感器 的 用 法 做 简单 介绍 。 


9.4.1 ”加 速度 传感器 
获取 加 速度 传感器 实例 的 代码 如 下 : 


private SensorManager mSensorManager; 
private Sensor mSensor; 


mSensorManager- (SensorManager) getSystemService 
(Context.SENSOR SERVICE) ; 
mSensor=mSensorManager .getDefaultSensor (Sensor. TYPE ACCELEROMETER) ; 


从 传感器 获取 数据 并 计算 三 个 方向 的 加 速度 的 代码 如 下 : 


public void onSensorChanged (SensorEvent event) { 
// In this example, alpha is calculated as t / (t+dT) , 
// where t is the low-pass filter's time-constant and 
// dT is the event delivery rate. 


final float alpha=0.8; 


// Isolate the force of gravity with the low-pass filter. 

gravity[0]=alpha * gravity[0]+ (1 - alpha) * event.values [0]; 
gravity[1]=alpha * gravity[1]+ (1 - alpha) * event.values [1]; 
gravity[2]-alpha * gravity[2]+ (1 - alpha) * event.values [2]; 


// Remove the gravity contribution with the high-pass filter. 
linear_acceleration[0]=event.values[0] - gravity[0]; 
linear_acceleration[1]=event.values[1] - gravity[1]; 
linear_acceleration[2]=event.values[2] - gravity[2]; 
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该 计算 方法 仅 是 举例 使 用 ， 实 际 计算 方法 要 针对 应 用 而 确定 。 


942 ”重力 传感器 


力 传感器 是 加 速度 传感器 的 一 种 ， 其 数据 处 理 方式 也 相似 。 此 处 就 不 再 重复 重力 传 感 
器 的 数据 计算 方法 。 获 取 重 力 传感器 的 代码 如 下 : 


private SensorManager mSensorManager ; 
private Sensor mSensor; 


mSensorManager= (SensorManager) getSystemService 
(Context .SENSOR_SERVICE) ; 
mSensor=mSensorManager .getDefaultSensor (Sensor.TYPE GRAVITY) ; 


9.43 ”陀螺 仪 
陀螺 仪 可 以 在 三 个 维度 上 测量 设备 的 旋转 情况 。 获 取 陀螺 仪 传感器 的 代码 如 下 : 


private SensorManager mSensorManager; 
private Sensor mSensor; 


mSensorManager= (SensorManager) getSystemService 
(Context .SENSOR_SERVICE) ; 
mSensor=mSensorManager .getDefaultSensor (Sensor.TYPE GYROSCOPE) ; 


从 陀螺 仪 数据 计算 三 个 维度 旋转 情况 的 代码 如 下 : 


// Create a constant to convert nanoseconds to seconds. 
private static final float NS2S=1.0f / 1000000000.0f; 
private final float[] deltaRotationVector=new float [4] (); 
private float timestamp; 


public void onSensorChanged (SensorEvent event) { 
// This timestep's delta rotation to be multiplied by the current 
rotation 

// after computing it from the gyro sample data. 

if (timestamp !=0) { 
final float dT= (event.timestamp - timestamp) * NS2S; 
// Axis of the rotation sample, not normalized yet. 
float axisX=event.values [0] ; 
float axisY=event.values [1] ; 
float axisZ=event.values [2]; 


// Calculate the angular speed of the sample 
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float omegaMagnitude=sqrt (axisX*axisX+axisY*axisY+axisZ*axisZ) ; 


// Normalize the rotation vector if it's big enough to get the axis 
// (that is, EPSILON should represent your maximum allowable margin 
of error) 
if (omegaMagnitude>EPSILON) { 
axisX /=omegaMagnitude; 
axisY /=omegaMagnitude; 
axisZ /=omegaMagnitude; 


} 


// Integrate around this axis with the angular speed by the 
timestep 

// in order to get a delta rotation from this sample over the 
timestep 


// We will convert this axis-angle representation of the delta 
rotation 
// into a quaternion before turning it into the rotation matrix. 
float thetaOverTwo-omegaMagnitude * dT / 2.0f; 
float sinThetaOverTwo-sin (thetaOverTwo) 
float cosThetaOverTwo-cos (thetaOverTwo) 
deltaRotationVector[0]-sinThetaOverTwo * axisX; 
deltaRotationVector[1]-sinThetaOverTwo * axisY; 
deltaRotationVector[2]-sinThetaOverTwo * axisZ; 
deltaRotationVector[3]-cosThetaOverTwo; 
} 
timestamp-event.timestamp; 
float[] deltaRotationMatrix-new float [9]; 
SensorManager.getRotationMatrixFromVector (deltaRotationMatrix, 
deltaRotationVector) ; 


i 
i 


// User code should concatenate the delta rotation we computed with 
the current rotation 


// in order to get the updated rotation. 
// rotationCurrent-rotationCurrent * deltaRotationMatrix; 


} 


9.4.4 ”线性 加 速 传感器 
线性 加 速度 传感器 是 传感器 的 一 种 。 其 获取 实例 的 代码 如 下 : 


private SensorManager mSensorManager; 
private Sensor mSensor; 


mSensorManager= (SensorManager) getSystemService 
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(Context .SENSOR SERVICE) ; 


mSensor=mSensorManager .getDefaultSensor 
(Sensor.TYPE LINEAR ACCELERATION) ; 


945 ”旋转 向 量 传感器 


旋转 向 量 传感器 能 反映 出 当前 设备 的 姿态 ， 其 返回 值 是 旋转 角度 与 旋转 轴 的 集合 。 获 取 
旋转 向 量 传感器 实例 的 相关 代码 如 下 : 


private SensorManager mSensorManager; 
private Sensor mSensor; 


mSensorManager= (SensorManager) getSystemService 


(Context .SENSOR_SERVICE) ; 
mSensor=mSensorManager .getDefaultSensor (Sensor.TYPE ROTATION VECTOR) ; 


本 章节 仅 是 对 运动 传感器 的 使 用 做 简单 介绍 。 要 深入 了 解 这 些 传感器 ， 还 请 读者 参阅 相 
关 文档 。 


D RELEE 


Android 平台 支持 的 位 置 传感器 主要 有 三 种 : 


* TYPE MAGNETIC FIELD 
* TYPE ORIENTATION 
* TYPE PROXIMITY 


下 面 对 着 三 种 传感器 做 简单 介绍 。 


9.5.1 ”磁场 传感器 
磁场 传感器 用 于 测量 地 球 磁场 的 强度 。 获 取 磁 场 传感器 实例 的 代码 如 下 : 


private SensorManager mSensorManager; 
private Sensor mSensor; 


mSensorManager= (SensorManager) getSystemService 


(Context .SENSOR_SERVICE) ; 
mSensor-mSensorManager.getDefaultSensor (Sensor.TYPE MAGNETIC FIELD) ; 
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磁场 传感器 获取 的 原始 数据 记录 的 是 在 三 个 方向 上 地 球 磁场 的 强度 。 通 常情 况 下 ， 这 些 
数据 并 不 会 直接 使 用 ， 而 是 和 旋转 向 量 传感器 、 加 速度 传感器 的 数据 一 起 去 计算 设备 的 位 置 
数据 。 


9.5.2 ”方位 传感器 


方位 传感器 用 于 监测 设备 相对 于 地 球 坐 标 系 的 位 置 。 方 位 传感器 从 Android 2.2 (API 
Level 8) 就 被 淘汰 ， 在 之 后 的 设备 上 的 访问 传感器 都 是 软件 传感器 。 
获取 方位 传感器 实例 的 代码 如 下 : 


private SensorManager mSensorManager; 
private Sensor mSensor; 


mSensorManager- (SensorManager) getSystemService 
(Context.SENSOR SERVICE) ; 
mSensor-mSensorManager.getDefaultSensor (Sensor.TYPE ORIENTATION) ; 


下 列 代码 演示 了 从 方位 传感器 获取 数据 的 过 程 : 


public class SensorActivity extends Activity implements 
SensorEventListener { 


private SensorManager mSensorManager; 
private Sensor mOrientation; 


GOverride 

public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState) ; 
setContentView (R.layout.main) ; 


mSensorManager- (SensorManager) getSystemService 
(Context.SENSOR SERVICE) ; 

mOrientation-mSensorManager.getDefaultSensor 
(Sensor.TYPE ORIENTATION) ; 


} 


Goverride 
public void onAccuracyChanged (Sensor sensor, int accuracy) { 


// Do something here if sensor accuracy changes. 
// You must implement this callback in your code. 


} 


@Override 
protected void onResume () { 
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super.onResume () ; 
mSensorManager.registerListener (this, mOrientation, 
SensorManager.SENSOR DELAY NORMAL) ; 


} 


GOverride 

protected void onPause() { 
super.onPause(); 
mSensorManager.unregisterListener (this) ; 


) 


GOverride 
public void onSensorChanged (SensorEvent event) { 
float azimuth angle-event.values [0]; 
float pitch angle-event.values[1]; 
float roll angle-event.values [2]; 
// Do something with these orientation angles. 


95.3 ”距离 传感器 


距离 传感器 用 于 探测 Android 设备 与 其 他 物体 的 距离 ， 例 如 手机 与 耳 杂 的 距离 。 
器 实例 的 代码 如 下 : 


private SensorManager mSensorManager; 
private Sensor mSensor; 
mSensorManager- (SensorManager) getSystemService 
(Context.SENSOR SERVICE) ; 
mSensor-mSensorManager.getDefaultSensor (Sensor.TYPE PROXIMITY) ; 


下 列 代码 演示 了 使 用 距离 传感器 的 方法 : 


public class SensorActivity extends Activity implements 
SensorEventListener { 
private SensorManager mSensorManager; 
private Sensor mProximity; 


@Override 

public final void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState) ; 
setContentView (R.layout.main) ; 


获取 距 


// Get an instance of the sensor service, and use that to get an 
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instance of 
// a particular sensor. 
mSensorManager= (SensorManager) getSystemService 
(Context .SENSOR_SERVICE) ; 
mProximity-mSensorManager.getDefaultSensor (Sensor.TYPE PROXIMITY) ; 


) 


GOverride 
public final void onAccuracyChanged (Sensor sensor, int accuracy) { 


// Do something here if sensor accuracy changes. 


) 


GOverride 
public final void onSensorChanged (SensorEvent event) { 


float distance-event.values [0] ; 
// Do something with this sensor data. 


} 


Goverride 
protected void onResume () { 
// Register a listener for the sensor. 


super .onResume () ; 
mSensorManager.registerListener (this, mProximity, 
SensorManager.SENSOR DELAY NORMAL) ; 


) 


Goverride 
protected void onPause()[ 
// Be sure to unregister the sensor when the activity pauses. 


super.onPause(); 
mSensorManager.unregisterListener (this) ; 


) 
} 


环境 传感器 


Android 平台 支持 的 环境 传感器 有 如 下 几 种 : 


* TYPE AMBIENT TEMPERATURE. 
* TYPE LIGHT, 

* TYPE PRESSURE. 

e TYPE RELATIVE HUMIDITY, 
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* TYPE TEMPERATURE. 


其 中 温度 传感器 在 Android 4.0 (API Level 14) 中 被 弃 用 。 
下 列 示例 代码 演示 了 使 用 压力 传感器 测量 大 气 气压 的 方法 。 其 他 环境 传感器 的 使 用 方法 
相同 ， 在 此 不 再 一 一 描述 : 


public class SensorActivity extends Activity implements 
SensorEventListener { 
private SensorManager mSensorManager; 
private Sensor mPressure; 


GOverride 
public final void onCreate (Bundle savedInstanceState) { 


super.onCreate (savedInstanceState) ; 
setContentView (R.layout.main) ; 


// Get an instance of the sensor service, and use that to get an 
instance of 

// a particular sensor. 

mSensorManager= (SensorManager) getSystemService 
(Context .SENSOR_SERVICE) ; 

mPressure=mSensorManager .getDefaultSensor (Sensor.TYPE PRESSURE) ; 


) 


GOverride 
public final void onAccuracyChanged (Sensor sensor, int accuracy) { 
// Do something here if sensor accuracy changes. 


) 


Goverride 

public final void onSensorChanged (SensorEvent event) { 
float millibars of pressure-event.values [0]; 
// Do something with this sensor data. 


} 


Goverride 
protected void onResume () { 
// Register a listener for the sensor. 


super .onResume () ; 
mSensorManager.registerListener (this, mPressure, 


SensorManager.SENSOR DELAY NORMAL) ; 


) 


@Override 
protected void onPause () { 
// Be sure to unregister the sensor when the activity pauses. 
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super.onPause(); 
mSensorManager.unregisterListener (this) ; 


} 
} 


9.7 ma 


本 章 主要 讲解 了 位 置 服务 的 相关 内 容 。 介 绍 了 和 位 置 服务 相关 的 类 和 接口 的 功能 。 

借助 于 Google Map API， 可 以 方便 地 实现 位 置 服务 应 用 程序 。 需 要 注意 的 是 ，Google 
Map API 并 不 是 Android SDK 自 带 的 包 ， 需 要 额外 配置 ， 其 调试 程序 所 使 用 的 AVD 和 之 前 的 
不 同 ， 需 要 支持 Google APIs, HE Activity 必须 继承 自 MapActivity， 而 不 是 Activity。 通 过 
MapView 类 的 对 象 可 以 从 网 络 下 载 Google Map 数据 ， 供 我 们 的 自己 的 应 用 程序 使 用 ， 但 是 
使 用 MapView 组 件 ， 必 须 指定 其 apiKey 属性 ， 否 则 不 能 正常 运行 。apiKey 必须 与 应 用 程序 
的 签名 密 钥 相 匹配 ， 本 章 也 介绍 了 在 Google 网 站 使 用 debug 密 钥 申请 对 应 的 apiKey 的 方 
法 。 

本 章 提供 实例 中 进行 定位 时 ， 为 了 便于 使 用 AVD 调试 应 用 程序 ， 使 用 的 都 是 GPS 定位 
方式 。 若 要 使 用 网 络 定 位 方式 ， 只 需要 将 LocationManagerGPS_PROVIDER 修改 为 
LocationManager NETWORK. PROVIDER 即 可 ， 其 他 代码 不 需要 改变 。 

位 置 服务 应 用 程序 是 Android 移动 设备 的 特色 服务 ， 有 很 大 的 市 场 。 希 望 本 章 的 简单 例 
程 能 将 读者 引入 位 置 服务 应 用 程序 开发 之 路 。 

本 章 对 传感器 编程 进行 了 简单 的 介绍 。Android 平台 支持 多 种 传感器 ， 通 过 传感器 可 以 
获取 数据 ， 各 种 传感器 的 编程 方式 基本 相同 ， 易 于 读者 掌握 。 活 用 传感器 ， 可 以 开发 出 极 具 
感染 力 的 应 用 程序 ， 传 感 器 已 被 越 来 越 多 地 应 用 于 Android 系统 下 手机 游戏 的 开发 。 
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练习 Overlay， 在 地 图 上 使 用 图 片 标注 一 个 地 点 。 

为 MapView 开发 自己 的 地 图 缩放 工具 条 。 

为 MapView 开发 自己 的 地 图 浏览 工具 条 。 

通过 Criteria 查找 免费 的 ， 高 精度 的 LocationProvider。 

尝试 开发 一 个 自动 调节 屏幕 亮度 的 应 用 程序 。 

尝试 开发 一 个 无 论 手 机 是 否 颠 倒 ， 都 可 以 使 图 片 正 向 显示 的 图 片 查看 程序 。 


Bo obe aS: m 
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* 2D 绘图 


* Drawable 
* 3D 绘图 
学 ”硬件 加 速 
* RenderScript 


第 10 章 绘 


Android 系统 提供 了 非常 地 强大 的 图 形 处 理 能 力 。Android 系统 对 于 2D 图 形 的 处 理 采 用 
了 自 定义 的 一 系列 2D 图 形 处 理 类 ， 而 没有 使 用 Java IDK 提供 的 图 形 处 理 类 。 这 些 自 定义 的 
类 分 别 位 于 android.graphics android.graphics.drawable.shapes 和 android.view.animation 包 
中 。 而 对 3D 图 形 进 行 处 理 的 类 分 别 位 于 javax.microedition.khronous.opengles 和 android. 
opengl 包 中 。 

Android 系统 中 的 图 形 处 理 基 本 可 以 分 为 两 类 。 一 类 是 针对 不 经 常 变化 的 图 像 ， 即 静态 
图 形 处 理 ， 另 一 类 是 针对 经 常 变化 的 图 像 ， 即 动态 图 形 处 理 。 


10.1 248 


Android API 提供 一 系列 进行 2D 绘图 的 方法 ， 被 放置 在 android.graphics.drawable 包 下 。 
通常 有 两 种 2D 绘图 的 方法 : 


e 在 布局 文件 定义 的 View 组 件 中 进行 绘图 。 绘 图 工作 由 系统 的 绘制 进程 管理 ， 开 发 者 
只 需 绘制 图 形 即 可 。 这 种 方式 适合 于 绘制 不 需要 实时 更 新 的 静态 图 像 。 

* 在 Canvas 中 绘图 。 这 种 方式 需要 由 开发 者 自己 调用 onDraw() 方 法 来 对 图 像 进行 给 
制 。 当 图 像 需要 定时 更 新 时 最 好 使 用 这 种 方式 ， 适 合 于 动画 绘制 和 视频 游戏 开发 。 


10.1.1 获取 Canvas 对 象 
要 在 Android 系统 下 绘制 图 形 ， 需 要 四 个 基本 组 件 ， 分 别 为 : 


* Bitmap: 相当 于 画布 ， 用 于 管理 像素 。 

* Canvas: 相当 于 在 在 Bitmap 上 绘图 的 画家 ， 用 于 管理 绘制 过 程 ， 提 供 绘图 方法 。 

* Drawable 绘制 要 素 : Drawable 绘制 要 素 包 括 形状 、 路 径 、 文 本 ， 图 像 等 ， 用 于 将 
Canvas 绘制 的 图 像 显示 给 用 户 。 

© Paint 相当 于 绘图 用 到 画笔 ， 可 以 设置 画笔 的 颜色 、 类 型 等 。 


若 在 自 定义 的 View 组 件 上 绘制 图 像 ， 只 需 重 写 onDraw() 方 法 即 可 。 示 例 代码 如 下 : 


public class MyView extends View { 
Goverride 
protected void onDraw (Canvas canvas) { 
// 使 用 Canvas 绘图 
} 
} 


如 果 需 要 新 建 一 个 Canvas， 则 必须 定义 一 个 Bitmap 对 象 用 于 绘图 。 获 取 Bitmap 对 象 ， 
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并 且 使 用 Canvas 绘图 的 示例 代码 如 下 : 


Bitmap b-Bitmap.createBitmap (100, 100, Bitmap.Config.ARGB 8888) ; 
Canvas c-new Canvas (b) ; 


// 使 用 Canvas 绘图 


若 使 用 SurfaceView 对 象 绘制 动态 图 像 ， 一 般 通 过 SurfaceHolder.lockCanvas0 方 法 获取 
Canvas 对 象 ， 然 后 通过 Canvas 进行 绘图 ， 绘 图 结束 后 通过 surfaceHolderunlockCanvasAndPost() 
方法 释放 Canvas 对 象 。 示 例 代码 如 下 : 


SurfaceHolder surfaceHolder-surfaceView. getHolder() ; 


Canvas canvas=surfaceHolder.lockCanvas() ; // 获 得 canvas 对 象 
// 使 用 Canvas 绘图 
surfaceHolder.unlockCanvasAndPost (canvas) ; // 释 放 canvas 


10.1.2 ”使 用 自 定义 View 绘图 


实例 MyViewCanvasDemo 自 定义 了 一 个 名 为 MyView 的 View 类 ， 并 在 其 onDraw0 方 法 
中 绘制 了 简单 的 图 像 ， 运 行 效果 如 图 10.1 所 示 。 


P MyViewCanvasDemo 


sow HEF Canvas s. 
ane "Rey 
2 全 


图 10.1 简单 View 绘图 


实例 MyViewCanvasDemo 没有 使 用 布局 文件 ， 而 是 将 自 定义 的 MyView 对 象 显示 出 来 。 
XE Activity MyViewCanvasDemoActivity 的 代码 如 下 : 


package introduction.android.MyViewCanvas; 
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import android.app.Activity; 
import android.os.Bundle; 


public class MyViewCanvasDemoActivity extends Activity { 
/** Called when the activity is first created. */ 
@Override 
public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState) ; 
setContentView (new MyView (this) ) ; 


MyView 类 的 定义 代码 如 下 : 
package introduction.android.MyViewCanvas; 


import android.content.Context; 
import android.graphics.Canvas; 
import android.graphics.Color; 
import android.graphics.Paint; 
import android.view. View; 


public class MyView extends View { 


public MyView (Context context) 1 
super (context) ; 
// TODO Auto-generated constructor stub 
buildPoints(); 


private float[] mPts; 
private static final float SIZE-300; 
private static final int SEGS-32; 
private static final int X-0; 
private static final int Y-1; 
@Override 
protected void onDraw (Canvas canvas) { 
// TODO Auto-generated method stub 
super.onDraw (canvas) ; 
// 使 用 Canvas 绘图 
/ /画布 移动 到 (10,10) 位 置 
canvas.translate (10,10) ; 
// 画 布 使 用 白色 填充 
canvas.drawColor (Color.WHITE) ; 
// 创 建 红色 画笔 ， 使 用 单 像素 宽度 ， 绘 制 直线 


Paint paint=new Paint (); 
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paint.setColor (Color.RED) ; 
paint.setStrokeWidth (0) ; 
canvas.drawLines (mPts, paint) ; 
// 创 建 蓝 色 画笔 ， 宽 度 为 3， 绘制 相关 点 
paint.setColor (Color .BLUE) ; 
paint.setStrokeWidth (3) ; 
canvas.drawPoints (mPts, paint) ; 

// 创 建 Bath， 并 沿 着 path 显示 文字 信息 
RectF rect=new RectF (10,300,290,430) ; 
Path path-new Path(); 
path.addArc (rect, -180, 180) ; 
paint.setTextSize (18) ; 
paint.setColor (Color.BLUE) ; 
canvas.drawTextOnPath ("在 自 定义 View 中 使 用 Canvas 对 象 绘图 实例 

",path, 0, 0, paint) ; 


} 


private void buildPoints() { 


// 生 成 一 系列 点 
final int ptCount= (SEGS+1) * 2; 


mPts=new float[ptCount * 2]; 


float value=0; 
final float delta=SIZE / SEGS; 
for (int i=0; i<=SEGS; i++) { 
mPts [i*4+X]=SIZE - value; 
mPts [i*4+¥] =0; 
mPts [i*4+X+2] =0; 
mPts [i*4+Y+2] =value; 
value+=delta; 


} 


所 有 具体 的 绘图 工作 都 由 Canvas 类 来 完成 。Canvas 类 提供 了 drawXXX() 方 法 来 完成 对 
特定 形式 的 图 形 的 绘制 。 

在 Canvas 绘图 过 程 中 ， 涉 及 了 以 下 几 个 类 : 

(1) Color 

颜色 类 ， 其 中 以 静态 常量 的 方式 定义 了 常见 的 各 种 颜色 ， 例 如 黑色 ColorBLACK， 蓝 色 
ColorBLUE 等 ， 同 时 也 可 以 通过 以 下 方法 指定 颜色 的 具体 值 来 建立 颜色 对 和 象 : 

© static int argb ( int alpha, int red, int green, int blue) 构造 一 个 包含 透明 要 素 的 颜色 对 象 。 

* static int rgb (int red, int green, int blue) 构造 一 个 由 RGB 三 色 组 成 的 颜色 对 象 。 
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(2) Paint 


画笔 类 ， 通 过 该 类 的 对 象 创建 绘图 时 使 用 的 画笔 的 样式 。 使 用 Paint.setColor0 方 法 设置 
画笔 的 颜色 ， 使 用 setStrokeWidth() 方 法 设置 画笔 的 宽度 。 

(3) Path 

路 径 类 ， 可 用 于 自 定义 各 种 路 径 。 本 实例 中 使 用 Path.addArc0 方 法 定义 了 一 个 弧 线 路 
径 ， 并 沿 着 该 路 径 显 示 了 说 明文 字 。 

Android 提供 了 各 种 各 样 的 用 于 绘制 图 形 的 方法 ， 在 此 不 可 能 一 一 介绍 ， 详 细 内 容 读者 
可 以 参考 Android SDK 文 档 。 


10.1.3 ”使 用 Bitmap 绘图 


可 以 通过 新 建 Bitmap 对 象 ， 并 在 其 上 使 用 Canvas 进行 绘图 的 方式 创建 图 像 。 实 例 
BitmapDrawDemo 演示 了 Canvas 使 用 Bitmap 对 象 绘图 的 过 程 。 该 实例 的 绘制 内 容 与 10.1.2 
节 实 例 的 绘制 内 容 完全 相同 ， 只 不 过 不 是 直接 绘制 在 View 上 ， 而 是 绘制 在 一 个 Bitmap 对 象 
上 ， 绘 制 完成 后 ， 将 Bitmap 图 像 显 示 到 视图 上 ， 其 运行 效果 如 图 10.2 所 示 。 


P" BitmapDrawDemo 


i 使 用 Canvas 对 x 
p sd c^ 


102 Bitmap 对 象 的 绘图 效果 


该 视图 显示 的 是 一 幅 Bitmap 图 像 。 实 例 BitmapDrawDemo 的 主 Activity 为 BitmapDraw- 
DemoActivity， 其 代码 如 下 : 


package introduction.android.bitmapDrawDemo; 


import java.io.ByteArrayOutputStream; 
import android.app.Activity; 
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import 
import 
import 
import 
import 
import 
import 
import 
import 
import 


public 


android.content.Context; 
android.graphics.Bitmap; 
android.graphics.BitmapFactory; 
android.graphics.Canvas; 
android.graphics.Color; 
android.graphics.Paint; 
android.graphics.Path; 
android.graphics.RectF; 
android.os.Bundle; 
android.view.View; 


class BitmapDrawDemoActivity extends Activity { 


private static final int WIDTH-320 ; 
private static final int HEIGHT-480 ; 
private static final int STRIDE-64; // must be»-WIDTH 


/** Called when the activity is first created. */ 
GOverride 
public void onCreate (Bundle savedInstanceState) { 


super.onCreate (savedInstanceState) ; 
setContentView (new MyBitmapView (this) ) ; 


private static Bitmap codec (Bitmap src, Bitmap.CompressFormat 
format,int quality) { 


ByteArrayOutputStream os=new ByteArrayOutputStream() ; 
src.compress (format, quality, os) ; 


byte[] array=os.toByteArray () ; 
return BitmapFactory.decodeByteArray (array, 0, 


array.length) ; 


} 


private class MyBitmapView extends View { 
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private Bitmap myBitmap; 

private float[] mPts; 
private static final float SIZE=300; 
private static final int SEGS=32; 
private static final int X=0; 
private static final int Y=1; 


@Override 

protected void onDraw (Canvas canvas) { 
// TODO Auto-generated method stub 
super.onDraw (canvas) ; 
canvas.drawBitmap (myBitmap, 0, 0,null) ; 


} 


public MyBitmapView (Context context) { 
super (context) ; 
// TODO Auto-generated constructor stub 
buildPoints(); 
myBitmap-Bitmap.createBitmap 
(WIDTH,HEIGHT,Bitmap.Config.ARGB 8888) ; 
Canvas canvas-new Canvas (myBitmap) ; 
// 使 用 Canvas 绘图 
// 画 布 移动 到 (10,10) 位 置 
canvas.translate (10,10) ; 
// 画 布 使 用 白色 填充 
canvas.drawColor (Color.WHITE) ; 
// 创 建 红色 画笔 ， 使 用 单 像素 宽度 ， 绘 制 直线 
Paint paint=new Paint(); 
paint.setColor (Color.RED) ; 
paint.setStrokeWidth (0) ; 
canvas.drawLines (mPts, paint) ; 
// 创 建 蓝 色 画 笔 ， 宽 度 为 3， 绘 制 相 关 点 
paint.setColor (Color .BLUE) ; 
paint.setStrokeWidth (3) ; 
canvas.drawPoints (mPts, paint) ; 
// 创 建 Path， 并 沿 着 path 显示 文字 信息 
RectF rect=new RectF (10,300,290,370) ; 
Path path=new Path(); 
path.addArc (rect, -180, 180) ; 
paint.setTextSize (18) ; 
paint.setColor (Color.BLUE) ; 
canvas.drawTextOnPath ("在 Bitmap 中 使 用 Canvas 对 象 绘图 实例 
",path, 0, 0, paint) ; 
myBitmap=codec (myBitmap, Bitmap.CompressFormat.JPEG, 80) ; 


} 


private void buildPoints() { 
// 生 成 一 系列 点 
final int ptCount= (SEGS+1) * 2; 
mPts=new float [ptCount * 2]; 


float value=0; 
final float delta=SIZE / SEGS; 
for (int i=0; i<=SEGS; i++) { 
mPts[i*4-X]-SIZE - value; 
mPts [i*4+Y]=0; 
mPts [i*4+X+2]=0; 
mPts [i*4+Y+2] =value; 
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valuet+=delta; 


} 
} 


该 实例 新 建 了 一 个 名 为 MyBitmapView 的 View 组 件 ， 在 该 组 件 的 构造 方法 中 创建 了 一 个 
名 为 myBitmap 的 Bitmap 对 象 ， 在 该 对 象 上 新 建 了 Canvas 对 象 并 绘制 了 图 像 。 绘 制 完成 后 ， 
通过 MyBitmapView 组 件 的 onDraw0 方 法 将 myBitmap 绘制 到 该 View 上 ， 最 后 通过 
BitmapDrawDemoActivity 将 MyBitmapView 显示 到 视图 上 。 


10.1.4 ”使 用 SurfaceView 绘制 静态 图 像 


使 用 SurfaceView 绘图 ， 需 要 为 SurfaceView 对 象 添加 SurfaceHoloder.Callback 接口 ， 并 
在 该 接口 的 surfaceCreated() 方 法 中 通过 lockCanvas() 方 法 获取 Canvas 对 象 ， 以 此 保证 当 获 取 
Canvas 时 ，SurfaceView 对 象 可 用 。 当 绘图 工作 完成 后 ， 通 过 SurfaceHoloder. unlockCanvas- 
AndPost() 方 法 将 绘图 显示 出 来 ， 并 释放 Canvas 对 象 。 

实例 SurfaceViewDrawDemo 演示 了 使 用 SurfaceView 组 件 绘制 静态 图 的 过 程 ， 其 绘制 内 
容 与 10.1.2 节 绘 制 内 容 完 全 相同 。 通 过 该 实例 ， 读 者 可 以 清楚 地 认识 到 使 用 SurfaceView 绘 
图 与 使 用 View 绘图 的 不 同 之 处 ， 该 实例 运行 效果 如 图 10.3 所 示 。 


n SurfaceViewDrawDemo 


gaCanvasjy. 
: QU E 


图 10.3 SurfaceView 绘图 效果 


实例 Surface ViewDrawDemo 使 用 的 布局 文件 main.xml 内 容 如 下 : 


<?xml version-"1.0" encoding-"utf-8"?» 
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<LinearLayout 


xmlns:android- "http://schemas.android.com/apk/res/android" 
android:layout width-"fill parent" 
android:layout height-"fill parent" 
android:orientation-"vertical"» 


«TextView 
android:layout width-"fill parent" 
android:layout height-"wrap content" 
android:text-"Gstring/hello" /> 


«SurfaceView 
android: id="@+id/surfaceView1" 
android: layout_width="fill parent" 
android: layout_height="fill parent" /> 


</LinearLayout> 


在 LinearLayout 布局 中 添加 了 一 个 SurfaceView 组 件 ， 通 过 该 组 件 进行 绘图 。 
实例 SurfaceViewDrawDemo 的 主 Activity 为 SurfaceDrawDemoActivity， 其 代码 如 下 : 


package introduction.android.surfaceViewDrawDemo; 


import android.app.Activity; 
import android.graphics.Canvas; 
import android.graphics.Color; 
import android.graphics. Paint; 
import android.graphics.Path; 
import android.graphics.RectF; 
import android.os.Bundle; 

import android.view.SurfaceHolder; 
import android.view.SurfaceView; 


public class SurfaceDrawDemoActivity extends Activity { 
private SurfaceView mySurfaceView; 
private float[] mPts; 
private static final float SIZE=300; 
private static final int SEGS=32; 
private static final int X-0; 
private static final int Y-1; 


/** Called when the activity is first created. */ 
@Override 
public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState) ; 
setContentView (R.layout.main) ; 


429 


Android 4.X 从 入 门 到 精通 


buildPoints(); 

mySurfaceView- (SurfaceView) findViewById (R.id.surfaceViewl) ; 
SurfaceHolder surfaceHolder-mySurfaceView. getHolder(); 
surfaceHolder.addCallback (new SurfaceHolder .Callback () { 


format, 


@Override 
public void surfaceChanged (SurfaceHolder holder, int 


int width, int height) { 
// TODO Auto-generated method stub 


} 


GOverride 
public void surfaceCreated (SurfaceHolder holder) { 
// 必须 在 该 方法 中 获取 Canvas 对 象 ， 才 能 保证 SurfaceView 可 用 
Canvas canvas=holder.lockCanvas () ; // 获 得 canvas 对 象 
// 使 用 Canvas 绘图 
// 画 布 移动 到 (10,10) 位 置 

canvas.translate (10,10) ; 

// 画 布 使 用 白色 填充 

canvas.drawColor (Color.WHITE) ; 

// 创 建 红 色 画笔 ， 使 用 单 像素 宽度 ， 绘 制 直线 

Paint paint=new Paint (); 

paint.setColor (Color.RED) ; 

paint .setStrokeWidth (0) ; 

canvas.drawLines (mPts, paint) ; 

// 创 建 蓝 色 画 笔 ， 宽 度 为 3， 绘 制 相关 点 

paint.setColor (Color.BLUE) ; 

paint.setStrokeWidth (3) ; 

canvas.drawPoints (mPts, paint) ; 

// 创 建 Path， 并 沿 着 path 显示 文字 信息 

RectF rect=new RectF (10,250,290,480) ; 

Path path=new Path(); 

path.addArc (rect, -180, 180) ; 

paint.setTextSize (18) ; 

paint.setColor (Color. BLUE) ; 

canvas .drawTextOnPath ("在 SurfaceView 中 使 用 Canvas 对 象 给 


制 静态 图 实例 ",path，0，0，Ppaint) ; 


并 显示 绘制 内 容 
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holder.unlockCanvasAndPost (canvas) ; //#j{ canvas 对 象 


@Override 
public void surfaceDestroyed (SurfaceHolder holder) { 


// TODO Auto-generated method stub 
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private void buildPoints() { 


// 生 成 一 系列 点 
final int ptCount= (SEGS+1) * 2; 
mPts=new float [ptCount * 2]; 
float value=0; 
final float delta=SIZE / SEGS; 
for (int i=0; i<=SEGS; i++) { 
mPts [i*4+X]=SIZE - value; 
mPts [i*4+Y] =0; 
mPts [i*4+X+2] =0; 
mPts [i*4+Y+2] =value; 
value+=delta; 


10.1.5 “使 用 SurfaceView 绘制 动态 图 像 


实例 SurfaceViewDrawDemo 绘制 的 是 一 幅 静 态 图 像 ， 而 使 用 SurfaceView 绘图 的 优点 在 
于 绘制 动态 图 像 。 绘 制 静态 图 像 的 过 程 应 该 在 一 个 单独 的 线程 中 完成 ， 而 不 应 该 在 主线 程 中 
进行 。 实 例 SurfaceViewDynDrawDemo 演示 了 使 用 SurfaceView 组 件 绘制 动态 图 像 的 过 程 。 
该 实例 修改 自 Android SDK 提供 的 实例 ， 绘 制 的 是 类 似 于 Windows 中 的 变幻 线 屏保 的 效果 ， 
运行 效果 如 图 10.4 所 示 。 


å 4:10 


P SurfaceViewDynDrawDemo 


图 10.4 ”实例 SurfaceViewDynDrawDemo 运行 效果 
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实例 Surface ViewDynDrawDemo 的 布局 文件 main.xml 内 容 如 下 : 


<?xml version-"1.0" encoding-"utf-8"?» 
«LinearLayout 
xmlns:android-"http://schemas.android.com/apk/res/android" 
android:layout width-"fill parent" 
android:layout height-"fill parent" 
android:orientation-"vertical"» 


«TextView 
android:layout width-"fill parent" 
android:layout height-"wrap content" 
android:text-"estring/hello" /> 


«SurfaceView 
android: id="@+id/surfaceView1" 
android: layout_width="fill parent" 
android: layout_height="fill parent" /> 


</LinearLayout> 


实例 Surface ViewDynDrawDemo 的 主 Activity 为 SurfaceViewDynDrawDemoActivity, H: 
代码 如 下 : 


package introduction.android.SurfaceViewDynDrawDemo; 


import 
introduction.android.SurfaceViewDynDrawDemo.SurfaceViewDynDrawDemoActivity 
B igThread ; 


android.app.Activity; 
android.graphics.Canvas; 
android.graphics. Paint; 
android.os.Bundle; 
android.util.Log; 
android.view.SurfaceHolder; 
android.view.SurfaceView; 


public class SurfaceViewDynDrawDemoActivity extends Activity { 

private SurfaceView mySurfaceView; 

private DrawingThread mDrawingThread; 

SurfaceHolder surfaceHolder; 

/** Called when the activity is first created. */ 

Goverride 

public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState) ; 
setContentView (R.layout.main) ; 
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mySurfaceView- (SurfaceView) findViewById (R.id.surfaceViewl) ; 
surfaceHolder-mySurfaceView. getHolder(); 
surfaceHolder.addCallback (new SurfaceHolder.Callback( )( 


@Override 
public void surfaceChanged (SurfaceHolder holder, int 


int width, int height) { 
// TODO Auto-generated method stub 


GOverride 
public void surfaceCreated (SurfaceHolder holder) { 
// TODO Auto-generated method stub 
mDrawingThread-new DrawingThread(); 
mDrawingThread.mSurface-surfaceHolder; 
mDrawingThread.start(); 


) 


GOverride 

public void surfaceDestroyed (SurfaceHolder holder) { 
// TODO Auto-generated method stub 
mDrawingThread.mQuit-true; 


static final class MovingPoint { 
float x, y, dx, dy; 


void init (int width, int height, float minStep) { 
x= (float) ( (width-1) *Math.random()) ; 
y= (float) ( (height-1) *Math.random()) ; 


(float) (Math.random()*minStep*2) +1; 
(float) (Math.random()*minStep*2) 41; 


float adjDelta (float cur, float minStep, float maxStep) { 
cur+= (Math.random()*minStep) - (minStep/2) ; 
if (cur«0 && cur»-minStep) cur--minStep; 
if (cur»-0 && cur«minStep) cur-minStep; 
if (cur»maxStep) cur-maxStep; 
if (cur<-maxStep) cur=-maxStep; 
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return cur; 


} 


void step (int width, int height, float minStep, float 


X+=0x; 
if (x<=0 || x>= (width-1) ) { 
if (x<=0) x=0; 
else if (x>= (width-1) ) x=width-1; 
dx=adjDelta (-dx, minStep, maxStep) ; 
} 
yt=dy; 
if (y<=0 || y>= (height-1) ) { 
if (y<=0) y=0; 
else if (y>= (height-1) ) y=height-1; 
dy=adjDelta (-dy, minStep, maxStep) ; 


class DrawingThread extends Thread { 


// These are protected by the Thread's lock. 
SurfaceHolder mSurface; 

boolean mRunning; 

boolean mActive; 

boolean mQuit; 


// Internal state. 
int mLineWidth; 
float mMinStep; 
float mMaxStep; 


boolean mInitialized-false; 
final MovingPoint mPointi-new MovingPoint(); 
final MovingPoint mPoint2-new MovingPoint(); 


static final int NUM OLD-100; 

int mNumOld-0; 

final float[] mOld-new float [NUM OLD*4]; 
final int[] mOldColor-new int [NUM OLD]; 
int mBrightLine-0; 


// X is red, Y is blue. 
final MovingPoint mColor-new MovingPoint () ; 


final Paint mBackground-new Paint(); 


maxStep) 
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final Paint mForeground-new Paint (); 


int makeGreen (int index) { 
int dist-Math.abs (mBrightLine-index) ; 
if (dist>10) return 0; 
return (255- (dist* (255/10) ) ) ««8; 


GOverride 
public void run() { 
mLineWidth= (int) 
(getResources().getDisplayMetrics().density * 1.5) ; 
if (mLineWidth<1) mLineWidth=1; 
mMinStep=mLineWidth * 2; 
mMaxStep=mMinStep * 3; 


mBackground.setColor (0xff000000) ; 
mForeground.setColor (OxffOOffff) ; 
mForeground.setAntiAlias (false) ; 
mForeground.setStrokeWidth (mLineWidth) ; 


while (true) { 

if (mQuit) { 

return; 

} 

// Lock the canvas for drawing. 

Canvas canvas-mSurface.lockCanvas(); 

if (canvas--null) ( 
Log.i ("WindowSurface", "Failure locking 

canvas") ; 

continue; 


// Update graphics. 
if (!mInitialized) { 
mInitialized-true; 
mPointl.init (canvas.getWidth(), 
canvas.getHeight(), mMinStep) ; 
mPoint2.init (canvas.getWidth(), 
canvas.getHeight(), mMinStep) ; 
meolor init (127, 127, 1); 
} else { 
mPoint1.step (canvas.getWidth(), 
canvas.getHeight(), 
mMinStep, mMaxStep) ; 
mPoint2.step (canvas.getWidth(), 
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canvas.getHeight (), 


(yx 


NUM OLD) ; 


mMinStep, mMaxStep) ; 
mColor.step (127, 127, 1, 3) ; 
} 
mBrightLine+=2; 
if (mBrightLine> (NUM_OLD*2) ) { 
mBrightLine=-2; 


} 


// Clear background. 
canvas.drawColor (mBackground.getColor()) ; 


// Draw old lines. 
for (int i-mNumOld-1; i>=0; i--) { 
mForeground.setColor (mOldColor [i] | makeGreen 


mForeground.setAlpha ( ( (NUM_OLD-i) * 255) / 


int p=i*4; 
canvas.drawLine (mOld[p], mOld[p+1], mOld[p+2], 


mOld[p+3], mForeground) ; 


} 


// Draw new line. 

int red= (int) mColor.x+128; 

if (red>255) red=255; 

int blue= (int) mColor.y+128; 

if (blue>255) blue=255; 

int color=0xff000000 | (red<<16) | blue; 
mForeground.setColor (color | makeGreen (-2) ) ; 
canvas.drawLine (mPointl.x, mPointl.y, mPoint2.x, 


mPoint2.y, mForeground) ; 


c.g 


mNumOld-1) ; 
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// Add in the new line. 
if (mNumOld>1) { 
System.arraycopy (mOld, 0, mOld, 4, (mNumOld-1) 


System.arraycopy (mOldColor, 0, mOldColor, 1, 


} 


if (mNumOld<NUM_OLD) mNumOld++; 
m01d[0]=mPoint1.x; 

mO1d [1] =mPoint1l.y; 

mO1d [2] =mPoint2.x; 

mO1d [3] =mPoint2.y; 

mO1dColor [0] =color; 
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// All done! 
mSurface.unlockCanvasAndPost (canvas) ; 


) 


需要 注意 的 是 ， 就 像 前 面 所 提 到 的 ， 绘 制 动 态 图 像 的 过 程 必须 在 一 个 单独 的 线程 中 完 
成 ， 而 不 能 在 主线 程 中 进行 。 在 该 实例 中 ， 绘 图 过 程 是 在 DrawingThread 中 完成 的 。 


" Y 7 
U.Z Drawable 


Drawable 是 “可 绘制 的 东西 ”的 抽象 类 ， 被 定义 在 android.graphics.drawable 包 下 。 该 类 
继承 了 很 多 代表 不 同形 状 的 子 类 ， 例 如 BitmapDrawable、ShapeDrawable、PictureDrawable 等 
等 。 开 发 者 也 可 以 定义 自己 的 用 于 特定 形状 绘制 的 子 类 。 

获取 Drawable 对 象 有 三 种 方式 : 


© 使 用 工程 资源 文件 中 保存 的 图 像 资源 。 
e 使 用 xml 文 件 定义 的 Drawable 属性 。 
e 通过 构造 方法 构建 。 


10.2.1 ”从 资源 文件 中 创建 Drawable WR 


添加 图 像 到 应 用 程序 工程 中 最 简单 的 方式 就 是 从 资源 文件 中 获取 图 像 。 资 源 文件 中 的 图 
像 资 源 会 被 放置 在 res/drawable/ 文 件 夹 下 ， 常 见 的 图 像 资源 类 型 有 PNG, JPG 和 GIF， 在 允 
许 的 情况 下 ， 建 议 优先 使 用 PNG 格式 的 图 像 ， 其 次 是 JPG 格式 的 图 像 。 系 统 会 自动 为 每 个 
drawable 文件 夹 下 的 资源 文件 生成 一 个 格式 为 R.drawable.xxx 的 ID 号 ， 在 工程 中 可 以 通过 该 
ID 使 用 该 资源 。 在 之 前 的 实例 中 ， 我 们 一 直 在 使 用 这 种 方法 。 

例如 ， 在 res/drawable/ 文 件 夹 下 有 一 个 资源 文件 为 my_ image.png， 系 统 为 其 生成 的 资源 
I 有 D 为 R.drawable.my_image， 则 在 ImageView 组 件 中 使 用 该 图 像 的 代码 如 下 : 


ImageView i=new ImageView (this) ; 
i.setImageResource (R.drawable.my image) ; 


如 果 要 获得 该 资源 的 Drawable 对 象 ， 可 使 用 如 下 代码 : 
Resources res=mContext .getResources () ; 
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Drawable myImage=res.getDrawable (R.drawable.my image) ; 


10.22 ”从 XML 文件 中 创建 Drawable 对 象 


以 TransitionDrawable 对 象 为 例 ， 假 设 xml 文件 中 的 描述 如 下 : 


«transition xmlns:android="http://schemas.android.com/apk/res/android"> 
<item android: drawable="@drawable/image_expand"> 
<item android: drawable="@drawable/image_collapse"> 

</transition> 


则 从 该 xml 文件 中 获取 TransitionDrawable 对 象 的 代码 如 下 : 


Resources res=mContext .getResources () ; 

TransitionDrawable transition= (TransitionDrawable) 
res.getDrawable (R.drawable.expand collapse) ; 

ImageView image- (ImageView) findViewById (R.id.toggle image) ; 
image.setImageDrawable (transition) ; 


获取 到 TransitionDrawable 对 象 后 ， 便 可 以 操作 该 对 象 。 例 如 : 


transition.startTransition (1000) ; 


10.2.3 ”使 用 构造 方法 创建 Drawable 对 象 


以 ShapeDrawable 为 例 ，ShapeDrawable 是 Drawable 的 子 类 ，ShapeDrawable 对 象 适合 于 


动态 绘制 二 维 图 形 。 下 列 代码 演示 了 使 用 ShapeDrawable 对 象 在 自 定义 View 组 件 上 绘制 一 个 
椭圆 的 过 程 : 
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public class CustomDrawableView extends View { 
private ShapeDrawable mDrawable; 


public CustomDrawableView (Context context) { 
super (context) ; 


int x=10; 
int y=10; 
int width=300; 
int height=50; 


mDrawable-new ShapeDrawable (new OvalShape()) ; 
mDrawable.getPaint().setColor (0xff74AC23) ; 
mDrawable.setBounds (x, y, x+width, yt+height) ; 


protected void onDraw (Canvas canvas) { 
mDrawable.draw (canvas) ; 


} 
} 


绘制 完成 后 ， 可 通过 下 列 代码 将 自 定义 的 View 组 件 设置 为 Activity 的 视图 : 
CustomDrawableView mCustomDrawableView; 
protected void onCreate (Bundle savedInstanceState) { 


super.onCreate (savedInstanceState) ; 
mCustomDrawableView=new CustomDrawableView (this) ; 


setContentView (mCustomDrawableView) ; 


} 
自 定义 的 View 组 件 也 可 以 通过 下 列 代码 被 放置 到 XML 文件 中 进行 使 用 : 


<introducton.android.shapedrawable.CustomDrawableView 
android: layout_width="fill parent" 
android:layout height-"wrap content" 


/» 


0.5 3D 绘图 


10.3.1 OpenGL ES 简介 


OpenGL 是 一 组 跨 平台 的 3D 图 像 处 理 API, Open GL 是 OpenGL 的 嵌入 式 版 本 ，Android 
系统 从 Android 1.0 开始 支持 OpenGL ES 1.0 和 1.1， 自 Android 2.2 (API Level 8) 开始 ， 
Android 框架 开始 支持 OpenGL 2.0 API。 

由 于 篇 幅 所 限 ， 在 此 不 可 能 详细 地 介绍 OpenGL ES 的 方方面面 ， 仅 能 简单 介绍 其 使 用 方 
法 。 详 细 资 料 读者 可 以 查询 Android SDK 的 相关 文档 。 


10.3.2 ”绘制 3D 图 像 实例 


使 用 OpenGL ES API 绘制 3D 图 像 ， 有 两 个 基础 的 相关 类 ， 一 个 是 GLSurfaceView 类 ， 
-个 是 GLSurfaceView.Renderer 接 口 。 
(1) GLSurfaceView 类 
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GLSurfaceView 类 是 SurfaceView HJ FX, (EH ARHI Surface 进行 OpenGL 绘图 泻 染 。 


GLSurfaceView 提供 以 下 功能 : 


e 管理 Surface, Surface 是 一 块 内 存 ， 可 以 被 加 载 到 View 视图 中 。 

e 管理 一 个 EGL 显示 ， 能 够 使 用 OpenGL 把 内 容 泻 染 到 surface 上 。 

e 接受 用 户 自 定 义 泻 染 器 用 于 实际 泻 染 。 

e 使 泻 染 器 在 单独 的 线程 总 运行 ， 和 更 新 UI 的 线程 相 分 离 。 

© Xd IS (on-demand rendering) 和 连续 泻 染 ( continuous rendering ) 。 

e 提供 一 些 可 选 工具 ， 如 OpenGL 调用 的 跟踪 调试 和 错误 检查 等 。 

(2) GLSurfaceView.Renderer 接口 

GLSurfaceView.Renderer 接口 定义 了 使 用 OpenGL 绘图 时 所 需 的 方法 。 该 接口 通过 


GLSurfaceView.setRenderer() 5j GLSurfaceView 关联 在 一 起 。 


该 接口 实现 以 下 三 个 方法 : 

© onSurfaceCreated(): 当 创 建 GLSurfaceView 对 象 后 该 方法 被 系统 调用 一 次 。 通 常 在 该 
方法 中 设置 OpenGL 环境 的 相关 参数 ， 初 始 化 OpenGL 图 形 对 象 等 。 

* onDrawFrame(): GLSurfaceView 对 象 每 一 次 重 绘 时 系统 都 会 调用 该 方法 。 该 方法 应 该 
执行 具体 的 绘图 工作 。 

© onSurfaceChanged(): 当 GLSurfaceView 对 象 的 几何 外 形 改 变 时 ， 和 包括 GLSurfaceView 
的 尺寸 发 生 改 变 、 设 备 屏幕 的 方向 发 生 改 变 等 情况 ， 该 方法 被 系统 调用 。 


实例 OpenGLDemo 演示 了 在 Activity 中 使 用 GLSurfaceView 和 GLSurfaceView.Renderer 


合作 绘制 三 维 图 形 的 过 程 。 该 实例 绘制 了 一 个 不 断 旋转 的 立方 体 ， 运 行 效果 如 图 10.5 所 示 。 
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| opencLoemo 


图 10.5 实例 OpenGLDemo 运行 效果 


给 


该 立方 体 为 MyCube 类 的 对 象 。MyCubejava 代码 如 下 : 


package introduction.android.openglDemo; 


import java.nio.ByteBuffer; 

import java.nio.ByteOrder; 

import java.nio.IntBuffer; 

import javax.microedition.khronos.opengles.GL10; 
class MyCube 

{ 

private IntBuffer vertexBuffer; 

private IntBuffer colorBuffer; 

private ByteBuffer indexBuffer; 


public MyCube() 

{ 

int one=65536; 

int vertex [] ={ 

-one, -one, -one, 
one, -one, -one, 
one, one, -one, 
-one, one, -one, 
-one, -one, one, 
one, -one, one, 
one, one, one, 
-one, one, one 


}; 


int colors[]={ 


0, B; 0, one, 
one, 0, 0, one, 
one, one, 0, one, 
0, one, 0, one, 
0, 0, one, one, 
one, 0, one, one, 
one, one, one, one, 
0, one, one, one 

hi 

byte index[]={ 

Or A 5, O Ga 
nie ise, S als oh 
Oy Wh Pp GDh Ry 
3 T eb 3 NOS 
M.D, Bp d GS 
zh XU 3i E mi 


441 


oid 4.X 从 入 门 到 精通 


ByteBuffer vbb=ByteBuffer.allocateDirect (vertex.length*4) ; 
vbb.order (ByteOrder.nativeOrder()) ; 
vertexBuffer-vbb.asIntBuffer(); 

vertexBuffer.put (vertex) ; 

vertexBuffer.position (0) ; 


ByteBuffer cbb-ByteBuffer.allocateDirect (colors.length*4) ; 
cbb.order (ByteOrder.nativeOrder()) ; 
colorBuffer-cbb.asIntBuffer(); 

colorBuffer.put (colors) ; 

colorBuffer.position (0) ; 


indexBuffer-ByteBuffer.allocateDirect (index.length) ; 
indexBuffer.put (index) ; 
indexBuffer.position (0) ; 


} 

public void draw (GL10 gl) 

{ 
gl.glFrontFace (GL10.GL_CW) ; 
gl.glVertexPointer (3, GL10.GL_FIXED, 0, vertexBuffer) ; 
gl.glColorPointer (4, GL10.GL_FIXED, 0, colorBuffer) ; 
gl.glDrawElements (GL10.GL TRIANGLES, 36, GL10.GL UNSIGNED BYTE, 

indexBuffer) ; 
} 
} 


该 立方 体 被 显示 在 GLSurfaceView 对 象 中 ， 由 GLSurfaceView.Renderer 接口 绘制 。 
GLSurfaceView 在 主 Activity 的 onCreate(0 方 法 中 被 创建 ， 相 关 代码 如 下 : 


package introduction.android.openglDemo; 
import android.app.Activity; 
import android.opengl.GLSurfaceView; 
import android.os.Bundle; 
public class OpenGLDemoActivity extends Activity { 
private GLSurfaceView myGLSurfaceView; 
/** Called when the activity is first created. */ 
@Override 
protected void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState) ; 
myGLSurfaceView=new GLSurfaceView (this) ; 
myGLSurfaceView.setRenderer (new CubeRenderer()) ; 
setContentView (myGLSurfaceView) ; 
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@Override 

protected void onResume () { 
super .onResume () ; 
myGLSurfaceView.onResume () ; 


} 


@Override 

protected void onPause() { 
super .onPause () ; 
myGLSurfaceView.onPause () ; 


} 
其 中 ， 


myGLSurfaceView.setRenderer (new CubeRenderer()) ; 


指定 了 GLSurfaceView 的 泻 染 器 为 CubeRenderer， 由 该 泻 染 器 控制 图 像 绘制 过 程 。 泻 染 


器 被 定义 在 CubeRendererjava 中 ， 有 具体 代码 如 下 : 


package introduction.android.openglDemo; 
import android.opengl .GLSurfaceView; 
import javax.microedition.khronos.egl.EGLConfig; 
import javax.microedition.khronos.opengles.GL10; 
class CubeRenderer implements GLSurfaceView.Renderer { 
private MyCube myCube; 
private float roate; 
public CubeRenderer()( 
myCube-new MyCube(); 
} 


public void onDrawFrame (GL10 gl) { 
// 填 充 屏幕 
gl.glClear (GL10.GL_COLOR_BUFFER_BIT | 

GL10.GL DEPTH BUFFER BIT) ; 

// 设 置 模型 视 景 矩阵 为 当前 操作 矩阵 
gl.glMatrixMode (GL10.GL MODELVIEW) ; 
// 将 坐标 原点 移动 到 屏幕 中 心 
gl.glLoadIdentity () ; 
// 移 动 坐标 系 
gl.glTranslatef (0, 0, -3.0f) ; 
1146 Y s lie pe hn A 
gl.glRotatef (roate, 0,1, 0); 
// 在 X 轴 方向 旋转 坐标 系 
gl.glRotatef (roate*0.25f, 1, 0, 0); 
// 开 启 项 点 坐标 
gl.glEnableClientState (GL10.GL VERTEX ARRAY) ; 
// 开 启 颜色 
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gl.glEnableClientState (GL10.GL COLOR ARRAY) ; 
// 绘 制图 形 

myCube.draw (gl) ; 

roate4-1.0f; 


public void onSurfaceChanged (GL10 gl, int width, int height) { 
gl.glViewport (0, 0, width, height) ; 
float ratio- (float) width / height; 
gl.glMatrixMode (GL10.GL PROJECTION) ; 
gl.glLoadIdentity(); 
gl.glFrustumf (-ratio, ratio, -1, 1, 1, 10) ; 


public void onSurfaceCreated (GL10 gl, EGLConfig config) { 
gl.glEnable (GL10.GL CULL FACE) ; 
gl.glClearColor (0.5F,0.5F,0.5F,1.0F) ; 


硬件 加 速 


从 Android 3.0 (API Level 11) 开始 ，Android 2D 泻 染 管线 被 设计 为 能 更 好 地 支持 硬件 加 
速 功能 。 硬 件 加 速 功能 将 所 有 在 View 组 件 的 Canvas 上 执行 的 绘制 操作 都 交 由 GPU 来 完成 。 
由 于 硬件 加 速 功能 需要 更 多 的 资源 ， 因 此 启用 硬件 加 速 功能 的 应 用 程序 会 耗费 更 多 的 内 存 资 


10.4.1 ”启用 硬件 加 速 


启用 硬件 加 速 最 简单 的 方法 是 在 总 体 上 位 整个 应 用 程序 打开 硬件 加 速 功能 。 如 果 应 用 程 
序 中 仅仅 使 用 了 标准 的 View 和 Drawable 对 象 进行 图 像 绘制 ， 那 么 在 总 体 上 打开 硬件 加 速 功 
能 不 会 出 现任 何 的 不 良 影响 。 但 是 ， 由 于 硬件 加 速 功能 并 不 是 被 所 有 的 2D 绘制 操作 所 支 
持 ， 因 此 对 于 一 些 自 定义 的 View 组 件 和 Drawable 对 象 的 绘制 ， 可 能 会 出 现 无 法 显示 、 异 常 
或 者 错误 泻 染 的 点 等 问题 。 为 了 避免 这 类 问题 的 发 生 ，Android 平台 提供 了 以 下 四 个 应 用 层 
次 的 硬件 加 速 开 关 设置 : 


* Application， 应 用 程序 级 。 
* Activity, MAA, 

e Window, BUA, 

e View, HFR. 
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在 Application 等 级 打开 硬件 加 速 功能 ， 则 整个 应 用 程序 中 所 有 的 绘图 工作 都 使 用 硬件 加 
速 。 打 开 方 法 是 在 应 用 程序 的 配置 文件 AndroidManifestxml 文件 的 <application> 中 添加 如 下 
代码 : 


<application android:hardwareAccelerated="true" ...> 
如 果 在 整个 应 用 程序 等 级 下 使 用 硬件 加 速 功 能 导致 了 某 些 问题 ， 则 可 以 针对 某 个 


Activity 具体 设置 是 否 打开 硬件 加 速 功 能 。 下 列 代码 表示 在 应 用 程序 等 级 启用 硬件 加 速 功 能 ， 
但 是 对 某 个 Activity 不 使 用 硬件 加 速 功能 : 


<application android:hardwareAccelerated="true"> 


<activity ... /> 
«activity android: hardwareAccelerated="false" /> 
</application> 


如 果 需 要 更 细 粒 度 的 控制 ， 可 以 通过 以 下 代码 使 某 个 窗口 获得 硬件 加 速 功能 。 


getWindow().setFlags ( 
WindowManager.LayoutParams.FLAG HARDWARE ACCELERATED, 
WindowManager.LayoutParams.FLAG HARDWARE ACCELERATED) ; 


就 目前 的 API 控制 来 讲 ， 仅 支持 打开 某 个 窗口 的 硬件 加 速 功能 ， 而 不 支持 关闭 某 个 窗口 
的 硬件 加 速 功能 。 

在 View 等 级 ， 可 以 在 运行 时 使 用 以 下 代码 关闭 某 个 View 组 件 的 硬件 加 速 功能 ， 但 是 在 
这 个 等 级 ， 只 能 关闭 硬件 加 速 功能 ， 不 能 启用 硬件 加 速 功能 。 

在 某 些 情况 下 ， 能 够 知道 当前 应 用 程序 或 者 某 个 自 定义 View 是 否 被 正确 地 硬件 加 速 是 
很 有 用 的 ， 尤 其 是 当 不 是 所 有 的 自 定义 的 绘图 操作 都 被 泻 染 管线 很 好 的 支持 的 时 候 。 

有 两 种 方式 可 以 确认 当前 应 用 程序 是 否 被 硬件 加 速 : 

e View.isHardwareAccelerated(): 当 View 被 附加 到 硬件 加 速 的 窗口 时 ， 返 回 true, 

* CanvasisHardwareAccelerated(): 当 Canvas 被 硬件 加 速 时 ， 返 回 true. 


如 果 必 须要 做 这 样 的 检查 ， 尽 量 使 用 Canvas.isHardwareAccelerated0 方 法 代 蔡 View. 
isHardwareAccelerated0 方 法 。 因 为 当 View 被 附加 到 硬件 加 速 的 窗口 时 ， 它 仍 有 可 能 被 使 用 非 
人 硬件 加 速 的 Canvas 进行 绘制 。 这 种 情况 在 因为 缓存 原因 将 View 绘制 到 位 图 中 时 经 常 发 生 。 


10.4.2 Android 绘图 模型 


1. 基于 软件 的 绘图 模型 


当 应 用 程序 需要 更 新 UI 的 某 一 个 部 分 时 ， 会 通过 更 改 了 内 容 的 View 组 件 调用 
invalidate0 方 法 将 当前 组 件 无 效 化 。 该 方法 触发 一 个 重 绘 消息 ， 该 消息 会 沿 着 视图 的 层次 一 
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直 向 上 传递 ， 以 计算 需要 重 绘 的 区 域 。 然 后 Android 系统 会 重 绘 在 视图 层次 中 与 要 重 绘 区 域 
有 交叉 的 所 有 组 件 。 
基于 软件 的 绘图 模式 主要 完成 如 下 两 个 工作 : 


e 无 效 化 绘图 层次 
e 重 绘 绘图 层次 


这 种 绘图 模型 有 两 个 缺点 : 

首先 ， 这 个 模型 会 导致 在 消息 传递 过 程 中 多 执行 大 量 无 效 的 绘图 代码 。 例 如 ， 一 个 按钮 
位 于 一 个 View 上 ， 当 该 按钮 被 单 击 时 ， 虽 然 该 View 没有 发 生 任 何 的 改变 ， 但 是 在 这 种 绘图 
模型 下 ， 该 View 也 会 被 重 绘 。 

第 二 个 缺点 是 这 种 绘图 模型 可 能 隐藏 应 用 程序 中 的 bug。 由 于 Android 系统 会 重 绘 所 有 
与 需 重 绘 区 域 有 交叉 的 View 组 件 ， 一 个 被 用 户 改 变 了 内 容 的 View 组 件 可 能 会 被 重 绘 ， 即 使 
该 组 件 没有 调用 invalidate(0 方 法 。 当 这 种 情况 发 生 的 时 候 ， 用 户 只 能 依靠 另外 一 个 组 件 的 重 
绘 操作 来 获取 自己 想 要 的 效果 ， 而 这 种 效果 可 能 会 不 断 改变 。 因 此 ， 开 发 者 应 该 在 自 定义 的 
组 件 上 不 断 的 调用 invalidate0 方 法 以 保证 内 容 显 示 正 确 ， 无 论 该 组 件 的 内 容 是 否 被 改变 。 

当 Android 组 件 的 内 容 发 生 改 变 ， 如 背景 色 改 变 或 者 文本 改变 时 ， 该 组 件 会 自动 调用 
invalidate() 方 法 。 


2. 硬件 加 速 绘制 模型 

在 硬件 加 速 绘制 模型 下 ，Android 系统 依然 使 用 invalidate() 方 法 和 draw( 方 法 来 对 屏幕 进 
行 更 新 并 绘制 图 形 ， 但 是 具体 处 理 的 方法 有 所 不 同 。 这 种 模式 下 Android 系统 并 没有 马上 执 
行 绘图 命令 ， 而 是 记录 了 当前 视图 的 显示 列表 。 显 示 列 表 中 包含 了 视图 层次 中 所 有 绘图 代码 
的 输出 。Android 系统 只 需要 录制 并 且 更 新 需要 重 绘 组 件 的 显示 列表 即 可 。 那 些 没 有 被 无 效 
化 的 组 件 可 以 简单 通过 重新 使 用 之 前 记录 的 显示 列表 的 方式 来 重 绘图 形 。 

硬件 加 速 绘图 模型 主要 完成 如 下 三 个 工作 : 


© 无 效 化 视图 的 绘图 层次 
e 记录 并 更 新 显示 列表 
e 绘制 显示 列表 


在 这 种 模式 下 ， 与 不 能 依靠 与 需要 更 新 区 域 有 交叉 的 组 件 的 draw0 方 法 来 更 新 图 像 ， 而 
是 应 该 调用 invalidate() 方 法 来 使 Android 系统 记录 组 件 的 显示 列表 。 如 果 没 有 这 样 做 ， 该 组 
件 的 更 新 将 不 会 显示 出 来 。 

使 用 显示 列表 方式 绘制 图 像 对 动画 绘制 也 有 很 大 好 处 。 因 为 设置 特定 属性 ， 例 如 透明 
度 、 旋 转 灯 ， 不 需要 重新 绘制 整个 视图 ， 而 只 需 对 特定 属性 进行 更 改 即 可 。 例 如 ， 假 如 有 一 
个 LinearLayout, ik LinearLayout 中 包含 一 个 ListView 组 件 和 一 个 Button HF, ListView 组 
件 被 放置 在 Button 组 件 的 上 面 。 该 LinearLayout 组 件 的 显示 列表 如 下 所 示 : 
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e DrawDisplayList ( ListeView ) 
© DrawDisplayList ( Button ) 


如 果 开 发 者 需要 更 改 ListView 的 透明 度 ， 那 么 通过 ListView 对 象 调 用 了 setAlpha 
(0.5f) 方法 后 ，LinearLayout 的 显示 列表 如 下 : 


SaveLayerAlpha (0.5 ) 
DrawDisplayList ( ListeView ) 
Restore 

DrawDisplayList ( Button ) 


由 此 可 见 ， 绘 图 ListView 的 复杂 代码 并 没有 被 执行 ， 系 统 只 是 简单 更 新 了 LinearLayout 
的 显示 列表 。 对 于 一 个 没有 被 硬件 加 速 的 应 用 程序 ， 该 过 程 中 的 每 一 行 代码 都 会 被 重新 执行 
一 次 


] 0 e 5 RenderScript 


Renderscript 基于 C99 标准 ， 提 供 了 一 个 平台 独立 的 运行 在 底层 的 计算 引擎 ， 用 于 加 速 需 
要 大 量 计算 的 应 用 程序 ， 常 用 于 3D 图 像 泻 染 。 

RenderScript 主要 优点 如 下 : 

e 可 移植 性 : RenderScript 被 设计 为 在 各 种 具有 不 同 CPU 和 CPU 架构 的 设备 上 运行 。 
由 于 其 代码 是 在 运行 设备 上 进行 编译 和 缓存 的 ， 因 此 RenderScript 可 以 支持 所 有 架构 
而 不 需要 针对 某 种 架构 具体 编程 。 

* 性 能 : RenderScript 能 够 提供 与 OpenGL 相似 的 性 能 ， 同 时 提供 与 Android 框架 提供 
的 OpenGL API (android.opengl ) 相同 的 移植 性 。 另 外 ，RenderScript 提供 OpenGL 所 
没有 的 高 性 能 计算 API。 

© 可 用 性 : RenderScript 尽 可 能 简化 了 开发 过 程 。 


当然 ，RenderScript 也 有 缺点 ， 主 要 表现 在 : 


e 开发 复杂 : RenderScript 提供 资金 的 API 集合， 开发 者 需要 重新 学 习 。RenderScript 处 
理 内 存 的 方式 与 OpenGL 不 同 。 

e 调试 可 见 : RenderScript 可 以 在 其 他 处 理 器 上 被 执行 ， 而 不 是 主 CPU 上 。 在 这 种 情况 
下 ， 调 试 变 得 很 困难 。 

e 特性 较 少 : RenderScript 不 像 OpenGL 那样 提供 很 多 特性 ， 例 如 压缩 纹理 格式 或 者 GL 
扩展 。 
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10.5.1 RenderScript 综述 


RenderScript 采用 的 是 主 从 结构 。 底 层 的 本 地 化 代码 被 高 层 的 运行 的 虚拟 机 中 的 Android 
系统 控制 。Android 虚拟 机 保有 内 存 和 声明 周期 的 控制 权 ， 在 需要 的 时 候 调用 本 地 的 
RenderScript 代码 。 本 地 化 代码 被 编译 为 中 间 的 字 节 码 ， 并 且 被 打包 到 应 用 程序 的 .apk 文件 
中 。 当 应 用 程序 在 设备 上 运行 的 时 候 ， 字 节 码 被 编译 为 针对 当前 机 器 优化 的 机 器 码 。 编 译 的 
字 节 码 被 缓存 起 来 ， 因 此 之 后 需要 使 用 RenderScript 代码 时 不 需要 重新 编译 。RenderScript 有 
三 个 层次 的 代码 ， 允 许 本 地 化 代码 和 Android 框架 之 间 进 行 通信 。 
© 本 地 RenderScript 层 : 该 层 负责 密集 运算 或 者 图 像 泻 染 ， 相 关 代 码 被 保存 在 .Is 或 
者 rsh 文 件 中 。 

e RHA: 该 层 由 一 系列 类 组 成 ， 这 些 类 由 本 地 代码 反射 而 来 。 基 本 上 是 对 本 地 代码 的 
包装 ， 以 允许 Android 框架 与 本 地 RenderScript 代码 进行 交互 。Android Build 工具 自 
动 生 成 该 层 的 相关 类 。 

* Android 框架 层 : 该 层 由 Android 框架 AI 组成， 包括 android.renderscript 包 。 该 层 用 
于 给 反射 层 发 出 高 级 命令 ， 如 “旋转 视图 ”或 者 “过 滤 位 图 ”， 然 后 反射 层 将 命令 传 
送 给 本 地 层 执行 。 


(1) 本 地 RenderScript 库 的 关键 特性 包括 : 


e 大 量 针对 标量 和 向 量 计 算 的 数学 函数 ， 包 含 加 、 乘 、 加 乘 、 点 乘 等 。 

e 原始 数据 与 向 量 的 转换 例 程 ， 珑 阵 例 程 、 日 期 和 时 间 例 程 、 图 像 例 程 等 。 

e 日 志 函 数 。 

e EUIS. 

e 内 存 分 配 请 求 特性 。 

支持 RenderScript 系 统 的 数据 类 型 和 结构 ， 例 如 二 维 向 量 、 三 维 向 量 、 思 维 向 量 等 。 


RenderScript 库 相 关头 文件 被 放置 在 <Androidsdk root»/platform-tools/renderscript/include 
目录 下 。 该 目录 下 的 头 文件 会 被 自动 保存 进 .rs 文件 中 ， 除 了 RenderScript 的 图 像 处 理 头 文 
件 。 因 此 需要 使 用 下 面 的 代码 手工 导入 : 


#include "rs_graphics.rsh" 


(2) 反射 层 是 一 组 由 Android Build 工具 生成 的 类 ， 可 以 从 Android 虚拟 机 访问 本 地 的 
RenderScript 代码 。 反 射 层 定义 了 RenderScript 函数 和 变量 的 访问 点 ， 以 便 Android 框架 能 够 
访问 透明 。 该 层 也 提供 了 构造 方法 ， 用 于 为 定义 在 RenderScript 代码 中 的 指针 分 配 内 存 。 

下 面 简单 介绍 被 反射 的 主要 组 件 : 

每 个 .rs 文件 都 生成 一 个 类 ， 被 存放 在 名 为 ScriptC_renderscript_filename 的 ScriptC 类 型 的 
文件 中 ， 它 相当 于 .rs 文件 的 java 版 本 ， 可 以 被 Android 框架 调用 。 该 类 包含 了 下 列 反射 : 
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e -Is 文件 中 的 非 静态 方法 。 
e 非 静 态 的 全 局 的 RenderScript € €. 
e 全 局 指针 。 


(3) Android 框架 层 由 通常 的 Android 框 架 API 组 成 ， 包 含 android.renderscript 包 。 该 层 
管理 Activity 的 声明 周期 以 及 应 用 程序 的 内 存 分 配 。 它 通过 反射 层 发 送 命令 给 本 地 
RenderScript 代码 ， 并 接收 用 户 事件 按 需 传递 给 RenderScript 代码 。 


10.5.2 ”使 用 动态 分 配 的 内 存 

涉及 RenderScript 内 存 分 配 API 的 类 有 三 个 : 

© Element: 内 存 分 配 的 基本 单位 ， 可 以 是 基本 的 数据 类 型 或 者 是 复合 类 型 。 

* Type: 表示 要 分 配 的 元 素 个 数 。 

* Allocation: 用 于 执行 分 配 内 存 操作 。 

RenderScript 支持 指针 ， 但 是 必须 在 Android 框架 代码 中 为 它 分 配 内 存 。 当 开发 者 在 .rs 文 
件 中 声明 一 个 全 局 的 指针 时 ， 需 要 通过 合适 的 反射 层 类 来 分 配 内 存 ， 并 将 其 绑 定 到 本 地 的 
RenderScript 层 。 开 发 者 可 以 通过 Android 框架 层 和 RenderScript 层 读 写 该 内 存 。 

1. 定义 指针 

由 于 RenderScript 使 用 的 是 C99 开发 的 ， 声 明 指针 的 方式 也 和 C99 语法 很 相似 。 下 列 代 
码 声 明了 一 个 Struct 结构 ， 并 为 其 定义 了 指针 ， 另 外 还 定义 了 一 个 指向 in32 t 类 型 的 指针 。 


#pragma version (1) 
#pragma rs java package name (com.example.renderscript) 


typedef struct Point ( 
float2 point; 
) Point t; 


Point t *touchPoints; 
int32 t *intPointer; 


这 些 代 码 需要 被 定义 在 rs 文件 中 。 


2. 反射 指针 
全 局 变量 会 有 对 应 的 get 和 set 方法 生成 。 一 个 全 局 指针 会 生成 一 个 bind_pointerName() 
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方法 以 代替 set 方法 。 该 方法 允许 将 Android 虚拟 机 分 配 的 内 存 绑 定 到 本 地 的 RenderScript。 
下 列 的 代码 是 为 前 面 代码 定义 的 两 个 指针 生成 存 取 方法 的 代码 : 


private ScriptField_Point mExportVar_touchPoints; 


public void bind touchPoints (ScriptField Point v) { 


mExportVar_touchPoints=v; 
if (v--null) bindAllocation (null, mExportVarIdx_touchPoints) ; 
else bindAllocation (v.getAllocation(), 


mExportVarldx touchPoints) ; 


) 


public ScriptField Point get touchPoints()[ 
return mExportVar touchPoints; 
) 


private Allocation mExportVar intPointer; 

public void bind intPointer (Allocation v) { 
mExportVar intPointer-v; 
if (v--null) bindAllocation (null, mExportVarIdx_intPointer) ; 
else bindAllocation (v, mExportVarIdx_intPointer) ; 


) 


public Allocation get intPointer()( 
return mExportVar intPointer; 
) 


这 些 代码 应 该 被 定义 在 ScriptC) — rs filename 文件 中 。 


3. 分 配 并 绑 定 内 存 到 RenderScript 
当 Build 工具 生成 反射 层 类 后 ， 就 可 以 使 用 合适 的 反射 层 为 指针 分 配 内 存 。 下 列 代 码 演 
示 了 为 intPointer 和 touchPoints 两 个 指针 分 配 内 存 并 绑 定 到 RenderScript 的 方法 : 


private RenderScriptGL glRenderer; 
private ScriptC_example script; 
private Resources resources; 


public void init (RenderScriptGL rs, Resources res) { 


2); 
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//get the rendering context and resources from the calling method 
glRenderer-rs; 
resources-res; 


//allocate memory for the struct pointer, calling the constructor 
ScriptField Point touchPoints-new ScriptField Point (glRenderer, 
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//Create an element manually and allocate memory for the int pointer 
intPointer-Allocation.createSized (glRenderer, Element .132 


(glRenderer) , 2) ; 


//create an instance of the RenderScript, pointing it to the 


bytecode resource 
mScript=new ScriptC_example (glRenderer, resources, R.raw.example) ; 


// bind the struct and int pointers to the RenderScript 
mScript.bind touchPoints (touchPoints) ; 
script .bind intPointer (intPointer) ; 


//pind the RenderScript to the rendering context 
glRenderer.bindRootScript (script) ; 


) 


4. 读 写 内 存 

虽然 内 存 是 由 Android 虚拟 机 分 配 ， 但 是 在 本 地 的 RenderScript 代码 和 Android 代码 中 都 
可 以 对 内 存 进行 读 写 。 一 旦 内 存 被 绑 定 ， 本 地 RenderScript 代码 就 可 以 直接 访问 内 存 ， 反 射 
层 类 也 可 以 通过 读 写 方法 访问 内 存 。 如 果 在 Android 框架 层 中 修改 了 内 存 内 容 ， 则 会 自动 同 
步 到 本 地 层 。 如 果 在 .rs 文件 中 修改 了 内 存 内 容 ， 则 这 些 改变 不 会 传递 回 Android 框架 层 。 下 
列 代码 演示 了 在 Android 代码 中 修改 Struct 的 方法 : 

int index=0; 

boolean copyNow=true; 


Float2 point=new Float2 (0.0f, 0.0f) ; 
touchPoints.set_point (index, point, copyNow) ; 


在 本 地 RenderScript 代码 中 读 取 该 内 存 的 代码 如 下 : 


rsDebug ("Printing out a Point", touchPoints[0] .point.x, 
touchPoints [0] .point.y) ; 


10.5.3 ”使 用 静态 分 配 的 内 存 


在 RenderScript 中 声明 的 非 静态 的 全 局 原始 数据 类 型 和 结构 体 很 容易 使 用 ， 因 为 这 些 内 
存 是 静态 分 配 的 。Android Build 工具 在 生成 反射 层 类 时 会 自动 为 这 些 变量 生成 存 取 方 法 ， 
发 者 可 以 通过 这 些 方法 来 使 用 静态 分 配 的 内 存 。 

例如 ， 在 RenderScript 代码 中 声明 如 下 变量 : 


uint32_t unsignedInteger-1; 
下 列 代 码 会 在 ScriptC_script_name.java 文件 中 被 生成 : 
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private final static int mExportVarIdx unsignedInteger-9; 
private long mExportVar unsignedInteger; 
public void set unsignedInteger (long v) { 
mExportVar unsignedInteger-v; 
setVar (mExportVarIdx unsignedInteger, v) ; 


) 


public long get_unsignedInteger () { 
return mExportVar unsignedInteger; 
} 


下 列 代码 来 自 ScriptField_ Pointjava， 显 示 的 从 Point 结构 体 生 成 的 反射 层 的 类 : 


package com.example.renderscript; 


import android.renderscript.*; 
import android.content.res.Resources; 


public class ScriptField Point extends 
android.renderscript.Script.FieldBase { 
static public class Item { 
public static final int sizeof-8; 


Float2 point; 


Item() { 
point-new Float2(); 
} 


private Item mItemArray [] ; 

private FieldPacker mIOBuffer; 

public static Element createElement (RenderScript rs) { 
Element .Builder eb=new Element .Builder (rs) ; 
eb.add (Element .F32_2 (rs) , "point") ; 
return eb.create(); 


} 


public ScriptField_ Point (RenderScript rs, int count) { 
mItemArray-null; 
mIOBuffer-null; 
mElement-createElement (rs) ; 
init (rs, count) ; 
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public ScriptField Point (RenderScript rs, int count, int usages) { 
mItemArray-null; 
mIOBuffer-null; 
mElement-createElement (rs) ; 
init (rs, count, usages) ; 


) 


private void copyToArray (Item i, int index) { 
if (mIOBuffer--null) mIOBuffer=new FieldPacker (Item.sizeof * 
getType().getX()/* count */) ; 
mIOBuffer.reset (index * Item.sizeof) ; 
mIOBuffer.addF32 (i.point) ; 


} 


public void set (Item i, int index, boolean copyNow) { 
if (mItemArray--null) mItemArray-new Item[getType().getX()/* 


count */]; 
mItemArray [index]-i; 
if (copyNow) { 
copyToArray (i, index) ; 
mAllocation.setFromFieldPacker (index, mIOBuffer) ; 
} 
} 


public Item get (int index) { 
if (mItemArray==null) return null; 
return mItemArray [index] ; 


} 


public void set_point (int index, Float2 v, boolean copyNow) { 
if (mIOBuffer--null) mIOBuffer=new FieldPacker (Item.sizeof * 
getType().getX()/* count */) fnati; 
if (mItemArray--null) mItemArray-new Item[getType().getX()/* 


count */]; 
if (mItemArray [index] ==null) mItemArray [index] =new Item() ; 
mItemArray [index] .point=v; 
if (copyNow) { 
mIOBuffer.reset (index * Item.sizeof) ; 
mlIOBuffer.addF32 (v) ; 
FieldPacker fp-new FieldPacker (8) ; 
fp.addF32 (v) ; 
mAllocation.setFromFieldPacker (index, 0, fp); 
} 
} 
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public Float2 get_point (int index) { 
if (mItemArray--null) return null; 
return mItemArray [index] .point; 


} 


public void copyAll() { 
for (int ct=0; ct<mItemArray.length; ct++) copyToArray 
(mItemArray [ct], ct) ; 
mAllocation.setFromFieldPacker (0, mIOBuffer) ; 
} 


public void resize (int newSize) { 
if (mItemArray !=null) { 
int oldSize-mItemArray.length; 
int copySize-Math.min (oldSize, newSize) ; 
if (newSize--oldSize) return; 
Item ni[]-new Item[newSize]; 
System.arraycopy (mItemArray, 0, ni, 0, copySize) ; 
mItemArray-ni; 


) 


mAllocation.resize (newSize) ; 
if (mIOBuffer !-null) mIOBuffer-new FieldPacker (Item.sizeof * 
getType().getX()/* count */) ; 


) 


. O 小 结 


本 章 简单 介绍 了 Android 系统 下 绘图 的 相关 方法 。Android 系统 提供 了 一 系列 方法 可 供 
发 者 绘制 自己 所 需要 的 2D 或 者 3D 图 像 。 

2D 图 像 的 绘制 使 用 的 是 Canvas 类 对 象 ， 通 过 该 对 象 开发 者 可 以 在 自 定义 的 View 组 件 
中 、 在 新 建 的 Bitmap 对 象 中 或 者 SurfaceView 对 象 中 绘图 。 通 常情 况 下 ，View 组 件 和 
Bitmap 对 象 适合 绘制 静态 图 像 ，SurfaceView 适合 绘制 动态 图 像 。 利 用 这 一 点 ， 可 以 使 用 
SurfaceView 进行 动画 或 者 游戏 界面 的 绘制 。 

3D 图 像 的 绘制 使 用 的 是 OpenGL ES. OpenGL ES 是 OpenGL 技术 在 嵌入 式 平台 上 的 移 
植 版 本 ， 借 助 于 OpenGL ES 提供 的 相关 API， 可 以 轻松 进行 3D 图 像 的 绘制 。 在 Android 平 
台 上 ， 绘 制 3D 图 像 使 用 的 是 GLSurfaceView 组 件 和 GLSurfaceView.Renderer 演 染 器 。 实 际 


454 


第 10 章 绘 


E, 3D 图 像 的 绘制 是 一 个 技术 含量 很 高 的 工作 ， 大 范围 地 应 用 于 3D 游戏 的 开发 中 。 本 章节 
篇 幅 有 限 ， 不 可 能 将 3D 图 像 绘 制 的 内 容 详细 描述 ， 仅 希望 能 够 作为 一 个 将 读者 带 入 3D 绘图 
技术 大 门 的 引路 石 。 

此 外 ， 由 于 图 形 绘制 过 程 中 需要 大 量 的 浮 点 数 运算 ， 而 Android 设备 特性 本 身 计算 能 力 
有 所 欠缺 ， 因 此 Android 平台 提供 了 硬件 加 速 功能 和 RenderScript 技术 用 于 处 理 计 算 。 对 于 
硬件 加 速 功能 ， 应 该 学 会 在 各 个 等 级 开关 相应 功能 以 提高 设备 的 绘图 能 力 。RenderScript 技术 
非常 有 利于 图 形 计 算 ， 但 是 由 于 其 运行 在 底层 ， 使 用 方式 和 正常 的 Android 框架 下 的 应 用 程 
序 有 所 不 同 。RenderScript 技术 是 仍 处 在 发 展期 的 技术 ， 不 同 Android SDK 版 本 针对 该 技术 
的 变换 比较 大 。 例 如 在 Android 4.0 版 本 中 的 RenderScriptGL 类 在 Android 4.1 版 本 中 就 被 弃 
用 了 。 在 目前 阶段 ， 建 议 读者 们 对 该 技术 以 了 解 为 主 。 


10.7 思考 题 


1. 怎样 使 用 自 定义 View 绘图 ? 

2. 怎样 使 用 Bitmap 22/8 

3. 怎样 使 用 SurfaceView 绘制 静态 图 像 和 动态 图 像 ? 

4. 练习 分 别 使 用 资源 文件 、XML 和 构造 方法 分 别 创建 Drawable 对 象 。 
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从 本 章节 可 以 学 习 到 : 
> 国际 化 与 本 地 化 

* 手机 区 域 设置 

学 未 本 地 化 的 应 用 程序 
S 本 地 化 的 应 用 程序 


98119 ”Android 的 国际 化 与 本 地 化 


10.1]. 国际 化 与 本 地 化 


国际 化 与 本 地 化 (Internationalization and localization) 是 指 调整 软件 ， 使 之 能 适用 于 不 同 
的 语言 和 地 区 。 

国际 化 是 指 在 设计 软件 过 程 中 将 软件 与 特定 语言 及 地 区 脱 钧 的 过 程 。 当 软件 被 移植 到 不 
同 的 语言 及 地 区 时 ， 软 件 本 身 不 需要 做 任何 的 改变 或 修正 。 本 地 化 则 是 指 当 移植 软件 到 不 同 
的 语言 及 地 区 时 ， 在 软件 内 部 加 上 与 特定 区 域 有 关 的 资讯 和 特色 的 过 程 。 国 际 化 意味 着 产品 
有 适用 于 任何 区 域 和 语言 的 能 力 ; 本 地 化 则 是 为 了 更 适合 于 特定 区 域 用 户 的 使 用 ， 而 另外 增 
添 的 特色 。 在 软件 开发 过 程 中 ， 国 际 化 只 需 做 一 次 ， 但 本 地 化 则 要 针对 每 个 不 同 的 区 域 分 别 
做 一 次 。 对 于 软件 开发 人 员 来 说 ， 他 们 实现 的 软件 的 国际 化 ， 而 对 于 不 同 地 区 的 用 户 来 说 ， 
他 们 感受 到 的 是 软件 的 本 地 化 。 

Internationalization (国际 化 简称 “Il8n”， 因 为 在 i Al n 之 间 还 有 18 个 字符 ， 
Localization( 本 地 化 ) 简称 “Ll0n”。 一般 说 明 一 个 地 区 的 语言 时 ， 用 “语言 地 区 ”的 形 
式 表 示 ， 如 “zh_CN”， 表 示 “ 汉 语 _ 中 国 大 陆地 区 ”， 即 简体 中 文 ， 而 “zh_TW” 表 示 “ 汉 
语 _ 中 国 台 湾 地 区 ”， 即 繁体 中 文 。 

Android 系统 框架 对 “I18n” 和 “L10n” 提 供 了 非常 好 的 支持 。Android SDK 并 没有 提供 
专门 的 API 来 实现 国际 化 ， 而 是 通过 对 不 同 的 资源 resource 文件 进行 不 同 的 命名 来 达到 国际 
化 的 目的 。 同 时 这 种 命名 方法 还 可 用 于 对 硬件 的 区 分 ， 例 如 ，res/drawable 目录 下 的 三 个 文件 
夹 drawable-hdipi, drawable-ldpi 和 dreaable-mdpi 就 是 为 了 适应 不 同 的 屏幕 分 辨 率 而 设立 的 。 


11.2 手机 区 域 设 置 


可 以 通过 手机 的 区 域 设 置 获 得 手机 的 本 地 化 功能 。 在 主 菜单 目录 下 ， 有 一 个 “Custom 
Local” 应 用 程序 ， 如 图 11.1 所 示 。 该 应 用 程序 用 于 对 手机 的 区 域 进行 设置 。 单 击 启动 该 应 用 
程序 ， 运 行 效果 如 图 11.2 所 示 。 可 以 看 到 ， 默 认 情况 下 ， 当 前 AVD 的 区 域 设置 为 
“en US”， 即 语言 为 英语 ， 区 域 为 United States. 

更 改 当前 区 域 设 置 为 “zh CN”， 并 单 击 “Seclect ‘zh CN" ”按钮 ， 则 当前 手机 被 设置 为 
汉语 ， 地 区 为 中 国 大 陆地 区 ， 运 行 效果 如 图 11.3 所 示 ， 可 见 列表 中 的 部 分 语言 变 为 了 中 文 。 
按 “ 回 退 ” 键 回 到 主 菜 单 ， 发 现 很 多 应 用 程序 的 语言 都 变 为 了 中 文 ， 如 图 11.4 所 示 。 
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O # # 


Clock Custom Loca Dev Tools 'en US' 


[= Custom Locale 


en_US - English (United States) 


balelist 00000 
en_NZ - English 


en_SG - English 


en_US - English 


en_ZA - English 


Browser Calculator Calendar 


es - Spanish 


Select 


图 11.1 主 菜单 图 11.2 


= Custom Locale 


Zh_CN - 中文 (中 国 ) 


uk UA - 乌克兰 文 
vi - 越南 文 


vi. VN - 越南 文 


zh_CN - 中 文 


zh_TW - 中 文 


Select 
'zh_CN' 


图 11.3 区 域 设 置 为 “zh_CN” 


钮 ， 弹 出 如 图 11.5 所 示 对 话 框 ， 在 其 中 可 以 添加 自己 想 要 的 
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es_ES - Spanish 


Add 
New... 


“Custom Local” 应 用 程序 


图 11.4 中 文 效果 


如 果 在 Custom Local 列表 中 未 发 现 想 要 的 区 域 设置 ， 则 可 以 自己 添加 。 单 才 


区 域 设置 选项 。 


Ff Add New 按 
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Custom Locale 


New locale code 


Add Add and 
Select 


图 11.5 添加 设置 对 话 框 


Android 4.0 平台 支持 的 “语言 地 区 ”列表 如 11.1 所 示 ， 凡 是 出 现在 下 面 列表 中 的 “ 语 
言 _ 地 区 ”代码 都 可 以 被 Android 4.0 系统 直接 识别 。 


表 11.1 Android 4.0 平 台 支 持 的 “语言 _- 地 区 ”列表 


言 地 区 言 地 区 
ET 


Italian, Italy Cit IT) Japanese (ja JP) Korean (ko KR) 


Lithuanian, Lithuania (lt LT) Latvian, Latvia (lv LV) Norway (nb NO) 


Dutch, Belgium (nl BE) Dutch, Netherlands (nl NL) Polish (pl PL) 


Portuguese, Brazil (pt BR) Portuguese, Portugal (pt PT) Romanian, Romania (ro RO) 
Russian (ru RU) Slovak, Slovakia (sk SK) Slovenian, Slovenia (sl SI) 


Serbian (sr RS) Swedish, Sweden (sv SE) Thai, Thailand (th TH) 
Tagalog, Philippines (tl PH) Turkish, Turkey (tr TR) Ukrainian, Ukraine (uk UA) 
Vietnamese, Vietnam (vi VN) Chinese, PRC (zh CN) Chinese, Taiwan (zh TW) 
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序 在 更 改 了 手机 的 


未 本 地 化 的 应 用 程序 


在 本 书 之 前 章节 的 实例 中 均 未 涉及 本 地 化 的 问题 ， 在 此 我 们 先 看 一 下 未 本 地 化 的 应 用 程 


区 域 设 置 后 运行 效果 会 有 什么 不 同 。 首 先 将 手机 区 域 设 置 为 “zh CN” o 


新 建 一 个 Eclipse Android Project， 名 为 “L10Demo”， 全 部 使 用 默认 设置 ， 不 做 任何 代 
码 修改 。 创 建 完成 后 ， 在 main.xml 文件 中 添加 如 下 代码 : 


<?xml version="1.0" encoding="utf-8"?> 
<LinearLayout 


xmlns:android-"http://schemas.android.com/apk/res/android" 


android:orientation- "vertical" 
android:layout width-"fill parent" 
android:layout height-"fill parent" 
> 

<TextView 
android: layout_width="fill parent" 
android: layout_height="wrap_ content" 
android:gravity-"center horizontal" 
android:text-"estring/text a" 
/» 

«TextView 
android:layout width-"fill parent" 
android:layout height-"wrap content" 
android:gravity-"center horizontal" 
android:text-"estring/text b" 
/» 

«Button 
android: id="@+id/flag_button" 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:layout gravity-"center" 
/> 


</LinearLayout> 


Main.xml 采用 LinearLayout 布局 ， 分 别 放置 了 两 个 TextView 和 一 个 Button, wA 


所 示 。 
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11.6 默认 设置 的 运行 效果 


Main.xml 所 使 用 的 资源 文件 res/values/strings.xml 代码 如 下 : 


<?xml version="1.0" encoding="utf-8"?> 
«resources» 


«string 
«string 
«string 
«string 
«string 


name="app_name">L10NDemo</string> 

name= "text_a"> 这 是 默认 的 strings .xml 资源 文件 </string> 
name="text_b"> 这 是 中 国 国旗 </string> 

name="dialog_title"> 未 本 地 化 </string> 

name= "dialog_text "> 本 对 话 框 中 的 内 容 没 有 本 地 化 ， 相 关 资 源 来 自 


values/strings.xml, </string> 
</resources> 


“L10nDemo” [I] 3E Activity Jj L10NDemoActivity, L10NDemoActivity.java 代码 如 下 : 


package introduction.android.110nDemo; 


import android.app.Activity; 

import android.app.AlertDialog; 

import android.content .DialogInterface; 
import android.os.Bundle; 

import android.view.View; 

import android.widget .Button; 


public class L10NDemoActivity extends Activity { 
/** Called when the activity is first created. */ 
@Override 
public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState) ; 
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setContentView (R.layout.main) ; 
Button b; 
(b= (Button) findViewById (R.id.flag button) ) .setBackgroundDrawable 
(this.getResources().getDrawable (R.drawable.flag) ) ; 
// build dialog box to display when user clicks the flag 
AlertDialog.Builder builder-new AlertDialog.Builder (this) ; 
builder.setMessage (R.string.dialog text) 
.SetCancelable (false) 
.SetTitle (R.string.dialog title) 
.SetPositiveButton ("Done", new 
DialogInterface.OnClickListener () { 
public void onClick (DialogInterface dialog, int id) { 
dialog.dismiss(); 
} 
Pe 
final AlertDialog alert=builder.create() ; 
// set click listener on the flag to show the dialog box 
b.setOnClickListener (new View.OnClickListener()( 
public void onClick (View v) { 
alert.show(); 


DE 


} 


L10NDemoActivity Jj main.xml 中 的 Button 设置 了 一 幅 图 像 ， 是 R.drawable.flag 指向 的 
图 像 文件 。 当 用 户 单 击 Button 时 ， 即 可 弹出 一 个 有 Done 按钮 的 AlertDialog， 显 示 
R.string.dialog text 指向 的 内 容 ， 运 行 效果 如 图 11.7 所 示 。 


未 本 地 化 


本 对 话 框 中 的 内 容 没 有 本 地 
化 ， 相 关 资 源 来 自 values/ 
strings.xml。 


图 11.7 按钮 修改 的 运行 效果 
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然后 将 手机 区 域 设置 修改 为 “en_ US”， 即 美式 英语 。 再 次 运行 该 实例 ， 运 行 效果 如 图 
11.8 所 示 。 再 将 手机 区 域 设 置 为 其 他 区 域 ， 运 行 效果 不 变 。 


| LoNDemo 


未 本 地 化 


本 对 话 框 中 的 内 容 没有 本 地 
化 ， 相 关 资 源 来 自 values/ 
strings.xml, 


图 11.8 ”区 域 修改 的 运行 效果 


可 见 实例 “Ll10nDemo” 在 不 同 的 区 域 设置 下 ， 运 行 效果 完全 相同 。 这 是 因为 Android 系 
统 对 于 未 实现 本 地 化 的 应 用 程序 ， 均 使 用 的 默认 资源 文件 ， 无 论 当前 手机 设备 被 设置 为 任何 
地 区 ， 应 用 程序 的 运行 效果 都 相同 。 


本 地 化 的 应 用 程序 


本 小 节 我 们 尝试 将 Ll0nDemo 实例 本 地 化 。 为 Ll0nDemo 工程 添加 汉语 、 德 语 、 日 语 、 
英语 支持 。 
语言 _ 国 家 和 为 其 所 建立 的 资源 文件 夹 的 对 应 关系 如 表 11.2 所 示 。 
表 11.2 语言 _ 国 家 和 资源 文件 夹 的 对 应 关系 表 


Locale Code Language / Country Location of strings.xml © |Location of flag.png 
Default Chinese / china res/values/ res/drawable/ 
zh-rCN [chinese / china res/values-zh-rCN res/drawable/ 

fr [French / France res/values-fr/ res/drawable-fr/ 

ja [eum / Japan res/values-ja/ res/drawable-ja-r7P/ 
en-rUS English / United States — | (res/values/) res/drawable-en-rUS/ 


Go) 在 res 目录 上 单 击 右键 ， 选 择 New | Android XMLFile, wA 11.9 所 示 。 在 弹出 的 对 
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话 框 中 设置 Resource Type 为 Values Project 为 “LIONDemo”、 文 件 名 为 
“strings.xml”， 然 后 单 击 Next 按钮 。 


f] New Android XML File [mmm] 
New Android XML File 
@ The destination file already exists 
Resource Type: [Values = 
Project: [Donpemo = 
File: strings.xml 
Root Element: 
(Bo rescurces. 


® = a a Gee) 


图 11.9 “New Android XMLFile” 对 话 框 


出 现 文件 夹 配置 对 话 框 ， 如 图 11.10 所 示 。 


{& New Android XML File 


Choose Configuration Folder e 


Optional: Choose a specific configuration to limit the XML to: 


Available Quali. ^ Chosen Qualifiers | Region 

B Country Code EX CN 
Network Code | TECN eae) 
FESmallest Scre.. | 


Ic 


Í Screen Height [i 
Size 
En Ratio 
e Orientation 
But Mode 
2. Night Mode 
图 bensiy 
M Touch Screen -~ 


Folder: /res/values-zh-rCN 


[o] < Back Next> | (i nish) (cencel 


图 11.10 文件 夹 配置 对 话 框 


EE? 从 左 侧 列表 中 选择 匿 ws ]， 然 后 单 击 “->” 按 钮 ， 为 语言 填写 两 个 字符 的 代码 
zh， 左 侧 列表 选择 Em ]， 单 击 “->” 按 钮 ， 为 地 区 填写 两 个 字符 的 代码 CN, X 
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击 Finish。 则 Eclipse 在 res 目录 下 建立 values-zh-rCN 文件 夹 ， 该 文件 夹 下 的 
strings.xml 用 以 存放 区 域 设置 为 “zh CN” 的 相关 资源 文件 。 


res/values-zh-rCN/strings.xml 文件 内 容 如 下 : 


<?xml version="1.0" encoding="utf-8"?> 
<resources> 
<string name="app name">L10NDemo</string> 
«string name-"text a"> 这 是 Values-zh-rCN 的 strings.xml 资源 文件 </string> 
«string name="text_b"> 这 是 中 国 国旗 </string> 
«string name="dialog title"> 已 经 本 地 化 </string> 
«string name="dialog_text "> 对 话 框 中 的 字符 串 已 经 本 地 化 ， 所 使 用 资源 来 自 
values-zh-rCN/strings.xml 资源 文件 。</string> 
</resources> 


CXX03 依照 同样 步骤 为 res 文件 添加 如 下 文件 夹 values-en-rUS、values- 位 、values-ja， 并 创 
建 对 应 的 string.xml X fF. 


res/values-en-rUS/strings.xml 文件 内 容 如 下 : 


<?xml version="1.0" encoding="utf-8"?> 
<resources> 
«string name-"app name">L10NDemo</string> 
«string name="text_a">local values from values-en- 
rUS/strings.xml</string> 
<string name="text_b">This is the flag of America.</string> 
«string name-"dialog title">Localised</string> 
«string name="dialog text">This dialog box"'"s strings are 
localised. For every locale, the text here will come from values-en- 
rUS/strings.xml.«/string» 
«/resources» 


res/values-fr /strings.xml 文件 内 容 如 下 : 


<?xml version="1.0" encoding="utf-8"?> 

<resources> 
<string name="app name">Bonjour, Localisation</string> 
<string name="text_a">Irai-je te comparer au jour</string> 
<string name="text_b">Tu es plus tendre et bien plus 


tempéré.</string> 
</resources> 


res/values-ja/strings.xml 文件 内 容 如 下 : 
<?xml version-"1.0" encoding-"utf-8"?» 


«resources» 
«string name-"text a"»b& b £45 UCP5tbti5tvLb5Ho—Hcuxo»? 
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</string> 
«string name="text_b">EP# be REEL, LPL BER HTH, 
</string> 
</resources> 


CXX04 依照 同样 步骤 为 L10nDemo 工程 的 res 目录 下 添加 drawable-en-rUS, drawable-fr, 


drawable-ja-rJP 目录 ， 并 将 美国 、 法 国 和 日 本 的 国旗 图 标 分 别 复 制 到 对 应 文件 夹 
下 。 此 时 工程 Ll0nDemo 的 res 目录 结构 如 图 11.11 所 示 。 


B res 
© drawable-en-rUS 
i flag.png 
© drawable-fr 


M flag.png 
© drawable-hdpi 
© drawable-ja-rJP 

R flag.png 
© drawable-Idpi 
© drawable-mdpi 
© layout 

国 mainxml 
© values 

因 strings.xml 
© values-en-rUS 

[R] stringsxml 
© values-fr 

X) stringsxml 
© values-ja 

R) strings.xml 
© values-zh-rCN 

因 stringsxml 


图 11.11 LlOnDemo [fj res 目录 结构 
至 此 ， 实 例 LlOnDemo 的 开发 过 程 结束 。 下 面 更 改 手机 的 区 域 配置 ， 运 行 应 用 程序 ， 查 
行 效果 。 
将 区 域 配置 修改 为 “en US”， 和 运行 效果 如 图 11.12 所 示 。 


看 运 


P 10NDemo 


图 11.12 BH “en_US” 


Localised 


This dialog box's strings are 
localised. For every locale, the 
text here will come from values- 
en-rUS/strings.xml. 


Done 


区 域 的 运行 效果 


由 运行 效果 可 见 ， 视 图 中 的 两 个 TextView 以 及 对 话 框 内 的 字符 串 都 已 经 本 地 化 ， 来 自 
values-en-rUS/strings.xml 文件 ， 按 钮 上 的 美国 国旗 图 标 来 自 drawable-en-rUS/flag.png 文件 。 
将 区 域 修改 为 “zh CN”， 运 行 效果 如 图 11.13 所 示 。 


对 话 框 中 的 字符 串 已 经 本 地 
化 ， 所 使 用 资源 来 自 values-zh- 
rCN/strings.xml 资 源 文件 。 


图 11.13 WE "zh CN" 


已 经 本 地 化 


Done 


区 域 的 运行 效果 


运行 效果 可 见 ， 视 图 中 的 两 个 TextView 以 及 对 话 框 内 的 字符 串 都 已 经 本 地 化 。 实 例 


LlOnDemo 中 并 没有 建立 drawable-zh-rCN 文件 夹 ， 按 钮 上 的 中 国 国 旗 图 标 来 自 默 认 资 源 


drawable 文件 夹 。 
将 区 域 修改 为 ff， 运 行 效果 如 图 11.14 所 示 。 
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@ 10:41 


EB Bonjour, Localisation 


未 本 地 化 


本 对 话 框 中 的 内 容 没 有 本 地 
化 ， 相 关 资 源 


strings.xml。 


图 11.14 设置 “人 ”区域 的 运行 效果 
由 运行 效果 可 见 ， 视 图 中 的 两 个 TextView 以 及 应 用 程序 的 标题 都 已 经 本 地 化 。 由 于 
values-fr/strings.xml 文件 中 未 包含 dialog text 变量 ， 因 此 文本 框 内 的 内 容 未 被 本 地 化 ， 而 是 使 
用 了 values/strings.xml 文件 中 的 dialog text 变量 。 按 钮 上 的 法 国 国旗 图 标 来 自 drawable- 


fi/flag.png 文件 。 
将 区 域 修改 为 ja， 运 行 效果 如 图 11.15 所 示 。 


Ux 
Tena tfe t EMBL C 
* 


* 
* 


本 对 话 框 中 的 内 容 没 有 本 地 


化 ， 相 关 资 源 来 自 values/ 


strings.xml, 


图 11.15 设置 “ja” 区 域 的 运行 效果 
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由 运行 效果 可 见 ， 视 图 中 的 两 个 TextView 已 经 本 地 化 。 由 于 values-ja/strings.xml 文件 中 
未 包含 app_name 和 dialog text 变量 ， 因 此 文本 框 内 的 内 容 和 应 用 程序 标题 都 未 被 本 地 化 ， 
而 是 使 用 了 values/strings.xml 文件 中 的 dialog text 变量 。 虽 然 实 例 Ll0nDemo 中 建立 了 
drawable-ja-rJP 文件 夹 ， 并 提供 了 flagpng 文件 ， 但 是 由 
于 “-ja-rJP” 后 级 与 “-ja” 后 缀 不一致， 因此 未 能 载 入 
日 本 国旗 图 标 ， 而 是 使 用 了 默认 的 drawable/flag.png 文 
件 。 


将 区 域 修 改 为 “ja-JP”， 可 以 和 drawable-ja-rJP A 
录 项 匹配 ， 日 本 国旗 图 标 被 载 入 到 应 用 程序 中 。 而 字符 
串 资 源 “values-ja” 虽 然 和 当前 区 域 不 在 同一 个 地 区 ， 
但 也 被 正常 载 入 。 这 是 因为 “values-ja” 仅 指定 了 语 
言 ， 而 没有 指定 地 区 ， 因 此 该 目录 下 的 资源 文件 可 以 被 
所 有 语言 为 日 语 的 区 域 所 使 用 。 运 行 效 果 如 图 11.16 所 
示 。 

Android 系统 根据 资源 文件 的 后 级 名 来 实现 应 用 程序 
的 国际 化 。 当 手机 被 指定 为 某 个 特定 区 域 后 ， 应 用 程序 
被 自动 读 取 对 应 后 级 的 文件 夹 下 的 资源 文件 ， 更 新 应 用 图 11.16 设置 “ja-Jp” 区 域 的 运行 效果 
程序 界面 ， 达 到 本 地 化 的 目的 。 当 某 资源 目录 仅 指定 了 
语言 而 没有 指定 地 区 时 ， 该 资源 可 以 被 所 有 使 用 该 语言 的 地 区 使 用 。 

在 每 个 区 域 的 本 地 化 资源 文件 中 ， 不 需要 包含 所 有 的 本 地 化 资源 ， 而 只 需 定义 与 默认 资 
源 不 同 的 本 地 化 资源 即 可 。 当 在 特定 区 域 的 资源 文件 中 找 不 到 对 应 的 本 地 化 资源 时 ，Android 
系统 会 自动 使 用 默认 的 资源 文件 。 

因此 ，Android 系统 要 求 工程 运行 所 需 的 所 有 默认 的 资源 都 必须 存在 。 如 果 应 用 程序 中 
缺少 某 个 默认 资源 ， 则 当 手 机 设备 被 设置 为 不 支持 的 语言 区 域 时 ， 应 用 程序 将 不 能 运行 。 例 
如 res/values/strings.xml 中 缺少 了 应 用 程序 运行 所 需 的 某 一 个 字符 串 变量 ， 当 应 用 程序 被 设置 
为 不 支持 的 地 区 ， 尝 试 载 入 该 默认 资源 时 ， 会 出 现 致命 错误 。 用 户 会 看 到 提示 应 用 程序 错误 
的 信息 和 强制 关闭 应 用 程序 的 按钮 。 这 种 错误 不 会 被 Eclipse 检查 出 来 ， 并 且 当 应 用 程序 运行 
于 支持 的 地 区 时 ， 该 错误 也 不 会 被 发 现 。 这 就 要 求 程序 开发 人 员 在 进行 应 用 程序 国际 化 开发 
时 格外 小 心 ， 避 免 这 种 错误 。 


小 结 


国际 化 与 本 地 化 是 应 用 程序 开发 过 程 中 很 重要 的 一 部 分 。 借 助 于 国际 化 ， 可 以 让 我 们 
发 的 应 用 程序 无 需 做 任何 修改 即 可 在 各 种 语言 环境 中 运行 。Android 框架 对 国际 化 和 本 地 化 
提供 了 很 好 的 支持 ， 通 过 资源 文件 夹 的 后 缀 的 匹配 来 完成 应 用 程序 的 本 地 化 工作 ， 该 匹配 过 
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程 无 需 开 发 人 员 参 与 ， 由 Android 系统 自动 完成 。 
Android 系统 的 本 地 化 工作 步骤 简单 ， 易 于 完成 ， 但 其 中 有 很 多 技巧 需要 读者 在 学 习 过 
程 中 慢 慢 积累 。 


11.6 思考 是 


1. 如 果 仅 使 用 默认 的 资源 文件 ， 当 手机 区 域 设 置 改变 时 ， 应 用 程序 会 怎样 ? 

2. 如 果 不 使 用 资源 文件 ， 而 直接 将 视图 中 的 字符 串 写 在 布局 文件 里 ， 当 手机 切换 区 域 设 
置 时 ， 应 用 程序 会 怎样 ? 

3. 在 本 地 化 过 程 中 ， 若 缺少 了 某 个 默认 资源 ， 应 用 程序 会 怎样 ? 

4. 当 手 机 的 区 域 设置 为 “fr CA”， 某 资源 目录 为 “values- 位 ”， 该 资源 在 什么 情况 下 会 
被 载 入 ? 

S. 手机 区 域 设 置 为 “fr CA”， 资 源 目录 为 “values-fr-rFR”， 该 目录 下 的 资源 能 否 被 载 
入 ? 
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从 本 章节 可 以 学 习 到 : 


学 应 用 程序 发 布 的 步骤 

> 为 什么 要 为 应 用 程序 签名 

* Android 的 签名 策略 

党 导出 未 签名 应 用 程序 

> 生成 签名 文件 

党 为 应 用 程序 签名 

+ 使 用 zipalign 工具 优化 应 用 程序 
* 发 布 到 Google Play Store 


Android 4.X 从 入 门 到 精通 


在 完成 对 Android 应 用 程序 的 开发 和 测试 工作 后 ， 就 可 以 将 应 用 程序 发 布 出 去 ， 供 用 户 
使 用 了 。 

Android 应 用 程序 在 发 布 之 前 ， 需 要 完成 一 系列 的 工作 。 本 章 以 第 10 章 的 实例 
GPSLocationInMap 为 例 ， 简 单 介绍 Android 应 用 程序 发 布 过 程 中 相关 的 一 系列 工作 ， 包 括 应 
用 程序 发 布 的 步 又、 应 用 程序 的 签名 、 版 本 定义 等 。 


] 2 .1 应 用 程序 发 布 的 步 又 


-个 Android 应 用 程序 从 开发 到 发 布 的 过 程 一 般 要 经 过 下 列 步骤 。 


EHO) 完成 开发 工作 ， 在 模拟 器 上 测试 运行 。 

Eo 将 应 用 程序 开发 过 程 中 的 调试 信息 移 除 。 

C€XX03 考虑 为 应 用 程序 添加 EULA ( End User License Agreement ) o 
CE) 为 应 用 程序 添加 自己 的 图 标 ， 取代 默认 的 Android 图 标 。 
GET 定义 应 用 程序 的 版 本 。 

CEs 为 应 用 程序 进行 签名 。 

GEO? 如 果 应 用 程序 使 用 了 Google Map API， 需 要 申请 Map API 密 钥 。 
Ces 在 真 机 上 测试 运行 。 

€XX09 测试 完成 后 ， 发 布 到 Google Play Store 或 者 其 他 应 用 程序 网 站 。 


其 中 应 用 程序 的 版 本 由 AndroidManifestxml 文件 中 的 <Manifes 刀 标签 指定 。 例 如 : 


«manifest xmlns:android-"http://schemas.android.com/apk/res/android" 
package-"introduction.android.gpsLocationInMapDemo" 
android:versionCode-"1" 

android:versionName-"1.0"- 


«/manifest» 


其 中 ，android:versionCode 为 一 个 整数 值 ， 代 表 应 用 程序 代码 的 相对 版 本 ， 也 就 是 版 本 
更 新 过 多 少 次 。 该 值 每 次 更 新 的 值 都 应 该 比 前 一 次 的 大 ， 以 便于 应 用 程序 检查 应 用 程序 是 否 
需要 升级 ， 此 处 表示 第 一 次 更 新 ; android:versionName 为 一 个 字符 串 值 ， 代 表 应 用 程序 的 版 
本 信息 ， 需 要 显示 给 用 户 ， 此 处 表示 1.0 版 本 。 
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12.2. 为 什么 要 为 应 用 程序 签名 


Android 系统 要 求 签名 机 制 ， 所 有 安装 在 Android 系统 上 的 软件 ， 必 须 都 经 过 签名 。 与 
Symbian 系统 要 求 对 安装 软件 进行 签名 的 目的 不 同 ，Android 系统 要 求 软件 签名 不 是 为 了 获得 
软件 在 Android 系统 上 安装 的 权限 ， 而 是 为 了 用 签名 辨别 软件 的 开发 者 。 

Android 系统 不 会 安装 没有 经 过 签名 的 应 用 程序 ， 所 有 的 Android 应 用 程序 都 要 求 开发 者 
使 用 一 个 证 书 来 进行 签名 。 该 证 书 的 私 钥 由 应 用 程序 的 开发 者 所 拥有 ，Android 系统 通过 该 
证 书 来 识别 应 用 程序 的 开发 者 。 只 有 使 用 同一 个 证 书签 名 的 应 用 程序 ， 才 能 被 Android 系统 
允许 进行 升级 、 覆 盖 安 装 等 操作 。 使 用 不 同 签名 的 两 个 应 用 程序 ， 即 使 其 包 名 和 类 名 完全 相 
同 ，Android 系统 也 不 会 允许 其 安装 在 同一 个 目录 下 。 

之 前 的 章节 中 提 到 过 ， 我 们 之 前 开发 的 应 用 程序 ， 没 有 经 过 我 们 的 签名 ， 却 可 以 在 模拟 
器 上 安装 并 且 运 行 ， 是 因为 在 开发 模式 下 编译 应 用 程序 的 ADT 工具 会 自动 使 用 默认 的 证 书 
来 对 应 用 程序 进行 签名 ， 以 便 其 可 以 在 模拟 器 上 运行 。 单 击 Eclipse 菜单 的 Window | 
Preferences | Android | Build ， 显 示 的 是 系统 默认 的 调试 用 的 签名 数字 证 书 (为 
debug.keystore) ， 如 图 12.1 所 示 。 

[© Preferences [EI 


type filter text Build or 


Build Settings: 
(V) Automatically refresh Resources and Assets folder on build 

V] Force error when external jars contain native libraries 

[Z] Skip packaging and dexing until export or launch. (Speeds up automatic builds on file save) 


Build output 
@ Silent 
Normal 
Verbose 
Default debug keystore: C:\Users\LB\android\debug.keystore 
—— 
Plug-in Development 
Remote Systems 
Run/Debug 
Server 
Team ~ 
aaa [Restore nemis [ appy | 
[o Cx) 
DL J 


图 12.1 系统 默认 的 数字 签名 


需要 注意 的 是 ， 使 用 debug keystore 进行 签名 的 应 用 程序 ， 只 能 在 模拟 器 上 允许， 而 不 
能 在 真 机 上 运行 。 在 真 机 上 运行 的 应 用 程序 ， 必 须 使 用 正式 的 证 书 进行 签名 。 
用 于 给 应 用 程序 签名 的 证 书 不 需要 是 权威 机 构 发 布 的 证 书 ， 开 发 者 可 以 生成 自己 的 签名 
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证 书 。 
Android 建议 的 签名 证 书 的 有 效 期 一 般 要 长 于 25 年 。Android 系统 只 有 在 应 用 程序 安装 
时 才 会 检查 证 书 的 过 期 时 间 。 若 安装 时 证 书 已 经 过 期 ， 则 应 用 程序 不 能 安装 。 若 在 应 用 程序 
安装 后 证 书 过 期 ， 则 不 会 影响 应 用 程序 的 正常 运行 ， 但 是 会 导致 该 应 用 程序 再 也 不 能 升级 。 
为 应 用 程序 进行 数字 签名 的 过 程 如 下 : 


e 导出 未 签名 的 应 用 程序 。 
e 获取 签名 文件 。 
e 为 应 用 程序 签名 。 


下 面具 体 讲解 数字 签名 的 实现 过 程 。 


12.3 android 的 签名 策略 


通常 情况 下 ，Android 为 所 有 的 应 用 程序 开发 者 推荐 的 签名 策略 是 所 有 的 应 用 程序 都 应 
该 使 用 同一 个 证 书 进 行 签名 ， 并 且 证 书 的 有 效 期 应 该 长 于 应 用 程序 的 生命 周期 。 这 样 做 的 原 
因由 以 下 三 点 : 


© 应 用 程序 升级 。 若 开发 者 希望 某 应 用 程序 可 以 无 颖 升级 到 新 版 本 ， 则 新 旧版 本 应 用 程 
序 必须 使 用 同一 个 证 书 进行 签名 ， 否 则 不 能 升级 。 如 果 使 用 的 不 是 同一 个 证 书签 名 ， 
则 新 的 应 用 程序 会 被 安装 到 一 个 完全 不 同 的 目录 下 ， 相 当 于 安装 了 一 个 新 的 应 用 程 
Fi, 而 旧 的 应 用 程序 不 能 升级 。 

© 应 用 程序 模块 化 。Android 系统 允许 多 个 以 同一 个 证 书签 名 的 应 用 程序 运行 在 同一 个 
进程 中 ， 并 将 其 看 作 是 一 个 应 用 程序 。 每 个 应 用 程序 可 以 以 模块 化 部 署 ， 在 升级 时 可 
以 独立 地 升级 其 中 的 某 一 个 模块 。 

© 允许 代码 或 者 数据 共享 。Android 提供 了 以 签名 为 基础 的 权限 机 制 ， 应 用 程序 可 以 为 
以 相同 证 书签 名 的 其 他 应 用 程序 公开 自己 的 功能 ， 这 样 就 可 以 在 相同 签名 的 应 用 程序 
之 间 共 享 代码 和 数据 。 


另外 一 个 决定 签名 策略 的 重要 因素 是 如 何 设置 签名 密 钥 的 有 效 期 。 


e 如 果 开 发 者 计划 升级 应 用 程序 ， 则 应 该 确保 签名 密 钥 的 有 效 期 超过 应 用 程序 的 生命 周 
期 。Android 建议 密 钥 的 有 效 期 应 该 长 于 25 年 。 一 旦 密 钥 过 期 ， 其 签名 的 应 用 程序 将 
再 也 无 法 升级 。 

e 如 果 使 用 同一 个 密 钥 为 多 个 应 用 程序 签名 ， 则 密 钥 的 有 效 期 应 该 长 于 其 中 任何 一 个 应 
用 程序 的 生命 周期 。 

e 如 果 开 发 者 计划 将 应 用 程序 发 布 到 Android Market 上 ， 则 密 钥 的 有 效 期 应 该 超过 


474 


第 12 章 ”应 用 程序 发 布 


20033 年 10 月 22 日 ， 以 便 保 证 应 用 程序 可 以 无 缝 升级 。 


12.4 导出 未 签名 应 用 程序 


使 用 Eclipse+ADT 的 方式 开发 应 用 程序 ， 会 使 得 整个 签名 过 程 变 得 简单 。 借 助 于 ADT, 


导出 未 签名 的 应 用 程序 仅 需 单 击 一 下 鼠标 即 可 。 


以 实例 GPSLocationInMap 为 例 ， 在 工程 上 单 击 右键 ， 选 择 Android Tools | Export 


Unsigned Application Package 选项 ， 如 图 12.2 所 示 。 


Compare Wii 
Restore from Local History... 
Android Tools 

Configure 


I New Test Project... 


New Resource File... 


Export Signed Application Package... 
Export Unsigned Application Package... 


Display dex bytecode 
图 12.2 Android Tools 子 菜单 


在 弹出 的 对 话 框 中 选择 路 径 ， 单 击 保存 按钮 即 可 将 未 经 过 debug.keystore 文件 签名 的 


GPSLocationInMap.apk 保存 起 来 ， 如 图 12.3 所 示 。 


圈 Export Project = 


JO TE « Data (Q) » book » signedApp 


~ [$s || a2 signedApp LÀ 


组 织 >” — Saxum 
ARF E a 
L GPSLocationInMapDemo.apk 
modas, 
& Windows? OS ( 
ca LARA (E) 
ca 工作 相关 (F) 
ca E (6) 
e LB (1) 
ca Data (Q) FE 


E- © 
修改 日 其 


16 KB 2012-06-10 20 


大 小 


Ee NOP SLocationinMapDemo.apk] 


SRBO: |v 


^ Ree 


文件 保存 后 ， 


12.3 ”保存 数字 签名 
会 弹出 一 个 提示 对 话 框 ， 如 图 12.4 所 示 。 
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(8 Android IDE Plug-in ===) 


A An unsigned package of the application was saved at 
Ay aAvoottunsignedApp\GPsLocationlnMepDemo.apk 


Before publishing the application you will need to: 
- Sign the application with your release key, 
- run zipalign on the signed package. Tete i is located in <SDK>/tools/ 


Aligning applications allows Android to use application resources 
more efficiently 


Cx) 


124 提示 对 话 框 


12.5 生成 签名 文件 


H 


生成 Android 签名 证 书 的 方式 有 两 种 : 一 种 是 使 用 ADT 工具 来 生成 签名 证 书 ， 一 种 是 使 


用 命令 行 方式 生成 签名 证 书 。 


1 


2.5.1 使 用 ADT 插件 


€XX0r» 在 Eclipse 工程 GPSLocationInMap 上 单 击 右键 ,选择 Android Tools | Export Signed 
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Application Package 选项 ， 在 弹出 的 对 话 框 中 选择 要 导出 的 项 目 (如 图 12.5 所 

) ， 单 击 Next 按钮 ， 出 现 keystore 文件 选择 对 话 框 ， 选 中 Create new keystore # 
选 按钮 ， 并 确定 要 保存 的 keystore 文件 的 保存 位 置 和 名 字 ， 并 确定 对 应 的 keystore 
文件 的 密码 。 此 处 将 keystroe 文件 保存 为 “Q:\bookmyKeystoreunyKeystore. 


keystore”， 密 码 为 “123456”， 如 图 12.6 所 示 。 单 击 Next 按钮 出现 密 钥 创建 对 
话 框 。 如 图 12.7 所 示 。 


Expert Android Application [es 
Project Chocks 


Performs a set of checks to make sure the application can be exported. 


Select the project to export 


Project GPSLocationinMapDeme Browse. 
No errors found. Clicie Nert. 


9 


| rc] nc 
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f] Export Android Application ESI fj Export Android Application [E 


72 ANNE 


Alios: 


Password: 


Be) || | ooi: 


Validity (years 25 


First and Last Name: Lee Bo 
Organizational Unit: Dep 
Organization: sag 

City or Locality: Shenyang 
State or Province: Liaoring 


Country Code (KX): 86 


[o] “<Back Net > Firish Cancel @ (cack |New >) Frish | (cencel 
图 12.6 keystore 文件 选择 对 话 框 图 12.7 创建 密 钥 对 话 框 


E 其 中 上 面 四 项 为 必 填 项 ，Alias 为 密 钥 的 别名 ，Validity 为 密 钥 的 有 效 期 ， 建 议 大 于 
25 年 。 所 有 内 容 填写 完毕 后 ， 单 击 Next 按钮 。 如 图 12.8 所 示 。 


(8 Export Android Application 


Destination and key/certificate checks 


A Destination file already exists. 


Destination APK file: Q:\book\unsignedApp\GPSLocationinMapDemo.a 


Certificate expires in 25 years. 
© WARNING: destination file already exists 


[o] [mede ] men | [finish 5) con 


图 12.8 目标 文件 签名 对 话 框 


EI 选择 要 签名 的 apk 文件 ， 单 击 Finish 按钮 ， 则 完成 对 该 目标 文件 的 签名 工作 ， 同 时 
生成 签名 文件 。 


12.5.2 ”使 用 keytool 工具 


使 用 命令 方式 生成 签名 文件 的 过 程 稍微 复杂 一 点 。 使 用 的 是 keytool 命令 ， 该 命令 位 于 
<JDK 安装 目录 >/bin 文件 夹 下 。 
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运行 cmd 命令 ， 输 入 “keytool -help” 回 车 ， 会 显示 keytool 命令 的 一 些 列 参数 的 用 法 ， 
如 图 12.9 所 示 。 


76001 
Corporation 


changealias 


provider| 


delete v1 
key: 


provid 


图 12.9 keytool 命令 


读者 可 以 自己 查阅 帮助 ， 在 此 就 不 一 一 介绍 了 。 


Keytool.exe 命令 用 于 生成 密 钥 ， 并 且 把 密 钥 信息 存放 到 keystore 文件 中 。 
运行 命令 行 “keytool -v -genkey -keystore e:\AndroidKey\mykeystore.keystore -alias mykey 
-validity 20000” 


其 中 参数 意义 如 下 : 


e -V 为 显示 详细 输出 信息 。 

* -genkey 为 产生 密 钥 。 

© -keystore<keystorefilename>.keystore 指定 生成 keystore 文件 的 文件 名 。 
e -alias<keyfilename> 指 定 密 钥 的 别名 。 

* -validity<days> 指 定 该 密 钥 的 有 效 期 限 ， 单 位 是 天 。 


该 命令 运行 后 出 现 密 钥 生成 向 导 ， 开 发 者 根据 要 求 填写 相应 信息 ， 即 可 生成 密 钥 ， 如 图 
12.10 所 示 。 具 体 步 又 说 明 如 下 : 


输入 keystore 密码 : (输入 密码 “123456”， 未 回 显 ) 
再 次 输入 新 密码 :( 输 入 密码 “123456”， 未 回 显 ) 
您 的 名 字 与 姓氏 是 什么 ? 
[Unknown]: Lee Bo 
您 的 组 织 单位 名 称 是 什么 ? 
[Unknown]: SIAS 
您 的 组 织 名 称 是 什么 ? 
[Unknown] : DEP 


您 所 在 的 城市 或 区 域名 称 是 什么 ? 
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[Unknown] : Shenyang 
您 所 在 的 州 或 省 份 名 称 是 什么 ? 
[Unknown]: Liaoning 
该 单位 的 两 字母 国家 代码 是 什么 
[Unknown]: cn 
CN-Lee Bo, OU-SIAS, O-DEP, L-Shenyang, ST-Liaoning, C=cn 正确 吗 ? 
(Gl: y 


正在 为 以 下 对 象 生 成 1,024 [y DSA 密 钥 对 和 自 签名 证 书 (SHAlwithDSA) (有 效 期 为 
20,000 X): 

CN-Lee Bo, OU-SIAS, O-DEP, L-Shenyang, ST-Liaoning, C-cn 

输入 <mykey> 的 主 密码 (如果 和 keystore 密码 相同 ， 按 回 车 ) : 

再 次 输入 新 密码 : 〈 输 入 密码 ， 未 回 显 ) 

[正在 存储 e:\AndroidKey\mykeystore.keystore] 


n 


至 此 ， 已 生成 开发 者 签名 证 书 ， 存 储 在 E:\AndroidKey\mykeystore.keystore 文件 中 。 开 发 
者 可 以 使 用 该 密 钥 对 应 用 程序 进行 签名 。 


图 12.10 密 钥 生成 向 导 


为 应 用 程序 签名 


有 了 签名 文件 后 ， 就 可 以 为 应 用 程序 签名 了 。 签 名 的 方式 也 分 ADT 方式 和 命令 方式 两 
种 。 
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12.6.1 ”使 用 ADT 插件 


使 用 ADT 方 式 对 应 用 程序 进行 签名 的 过 程 非常 简单 。 

在 Eclipse 中 ， 右 击 GPSLocationInMap 工程 ， 选 择 Android Tools | Export Signed Application 
Package 选项 ， 在 弹出 的 对 话 框 中 选择 要 导出 的 项 目 ， 单 击 Next 按钮 ， 在 弹出 keystore 文件 选 
择 对 话 框 中 选中 Use existing keystore 单 选 按钮 ， 使 用 12.4.1 节 中 生成 的 mykeystore.keystore 文件 
(如 图 12.11 Pras) ， 并 输入 密码 “123456”， 单 击 Next， 在 出 现 的 对 话 框 中 选择 要 使 用 的 密 钥 
的 别名 ， 并 输入 密 钥 的 密码 ， 如 图 12.12 所 示 ， 单 击 Next 按钮 ， 在 如 图 12.13 所 示 的 对 话 框 中 
选择 签名 后 的 文件 的 保存 位 置 和 名 字 ， 单 击 Finish， 签 名 过 程 完成 。 


8] Esport Android Application. [ER] (E Export Android Application. aam] 
Keystore selection © Key alias selection e 
© Use existing keystore © Use existing key 
© Create new keystore Alas [mykey z) 
Location: O\book\mykeystore\myKeystore.keystore Browse. pP 
Password: e0000q Ð Create new key 


® Erish ] Gnesi] ® < Back Next > Finish Cancel 


12.11 "Keystore selection” 对 话 框 图 12.12 Key alias selection 界面 


18] Export Android Application Srce] 


Destination and key/certificate checks e 


Destination APK fle: Q:\book\signedApp\GPSlocationinMapDemo.apk | Browse. 


u Jun 04 20:41:41 CST 2037. 
25 years. 
Make sure the certificate is valid for the planned lifetime of the product. 


If the certificate expires, you will be forced to sign your application with a difierent 
one. 


Applications cannot be upgraded if their certificate changes from cne version to 
another, forcing a full ninstall/install which will make the user lose his/her data. 
Android Market currently requires certificates to be valid until 2033. 

* WARNING: destination fle already exists 


(o [Brem JI 


图 12.13 Destination and key/certificate checks 界面 
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12.62 ”使 用 jarsigner 工具 


使 用 命令 方式 进行 签名 ， 使 用 的 是 jarsigner 命令 ， 该 命令 和 keytool 命令 一 样 ， 被 放置 在 
<JDK 的 安装 目录 >\bin 文件 夹 下 。 

在 cmd 窗口 中 运行 “jarsigner -help”， 显 示 该 命令 的 各 个 参数 的 具体 用 法 ， 如 图 12.14 
所 示 〔 在 此 不 一 一 介绍 ) 。 


6.1.7600] 
soft Corporation 


图 12.14 jarsigner 命令 


未 签名 的 apk 文 件 使 用 12.3 节 中 导出 的 GPSLocationInMap.apk 文件 。 运 行 cmd 命令 ， 将 
命令 路 径 设 置 到 未 签名 apk 文件 所 在 目录 ， 此 处 为 “Q:\bookvwunsignedApp”。 签 名 的 证 书 文 
件 使 用 12.4.2 节 中 生成 的 签名 文件 ， 保 存 路 径 为 “e:/Androidkey/mykeystore.keystore”。 

使 用 jarsigner 为 GPSLocationInMap.apk 文件 签名 的 命令 为 “jarsigner -verbose -keystore 
e:/Androidkey/mykeystore.keystore GPSLocationInMapDemo.apk mykey”， 其 中 : 


€ -verbose 表示 开启 详细 输出 。 
* -keystore<keystorefilename>.keystore 指定 用 于 签名 的 keystore 文件 的 文件 名 。 
© mykey 表 示 用 于 签名 的 密 钥 的 别名 。 


运行 结果 如 图 12.15 所 示 。 


输入 密 钥 库 的 口令 短语 (输入 “123456”) 
正在 添加 : META-INF/MANIFEST.MF 
正在 添加 : META-INF/MYKEY .SF 
正在 添加 : ©META-INF/MYKEY.DSA 
正在 签名 :res/1Layout/main .xml 
正在 签名 : ”AndroidManifest .xml 
正在 得 名 : resources.arsc 
正在 得 名:  res/drawable-hdpi/ic launcher.png 
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正在 签名:  res/drawable-ldpi/ic launcher.png 
正在 签名 : res/drawable-māpi/ic_launcher.png 
正在 签名 :classes.dex 


至 此 ， 完 成 了 对 GPSLocationInMap.apk 的 签名 工作 。 


图 12.15 ”使 用 jarsigner 为 GPSLocationInMap.apk 文 件 签名 的 运行 结果 


使 用 zipalign 工具 优化 应 用 程序 


Android SDK 包含 一 个 名 为 zipalign 的 工具 ， 存 放 在 tools 文件 夹 下 。 该 工具 能 够 对 打包 
的 apk 应 用 程序 进行 优化 ， 将 资源 文件 对 齐 到 4 字 节 边界 ， 以 加 快 资源 的 读 取 速度 。 使 用 
zipalign 工具 优化 过 的 应 用 程序 ， 在 运行 时 可 以 使 Android 与 应 用 程序 间 的 交互 更 加 有 效率 ， 
让 应 用 程序 和 整个 系统 运行 得 更 快 。 因 此 签名 的 应 用 程序 在 发 布 之 前 应 该 使 用 zipalign 工具 


来 得 到 优化 后 的 版 本 。 

使 用 ADT 插件 签名 的 应 用 程序 ，Eclipse 会 自动 使 用 zipalign 工具 进行 优化 ， 因 此 不 需要 
我 们 人 工 干 预 。 

使 用 命令 方式 签名 的 应 用 程序 ， 需 要 使 用 zipalign 工具 优化 。 优 化 方法 如 下 : 


运行 cmd， 切 换 到 签名 的 apk 应 用 程序 所 在 目录 ， 以 12.5.2 节 签 名 的 Q:\book\ 
unsignedApp\GPSLocationInMapDemo.apk 文件 为 例 ， 对 其 优化 需 运 行 如 下 命令 : 


zipalign -v 4 GPSLocationInMapDemo.apk GPSLocationInMapDemo_aligned.apk 


其 中 -v 表示 开启 详细 输出 ，4 表示 对 齐 字 节 的 个 数 ， 必 须 为 4 才能 起 到 优化 效果 。 该 命 
令 运行 结果 如 下 : 


Verifying alignment of GPSLocationInMapDemo_aligned.apk (4) ... 
50 META-INF/MANIFEST.MF (OK - compressed) 
464 META-INF/MYKEY.SF (OK - compressed) 
946 META-INF/MYKEY.DSA (OK - compressed) 
1784 res/layout/main.xml (OK - compressed) 
2275 AndroidManifest.xml (OK - compressed) 
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3076 resources.arsc (OK) 

4476 res/drawable-hdpi/ic launcher.png (OK) 

8508 res/drawable-ldpi/ic launcher.png (OK) 

10108 res/drawable-mdpi/ic launcher.png (OK) 

12349 classes.dex (OK - compressed) 
Verification successful 


运行 效果 如 图 12.16 所 示 。 


EE C\Windows\system32\emd.exe 


图 12.16 zipalign 优化 


的 是 ， 该 优化 必须 在 签名 之 后 进行 。 若 先进 行 优化 再 对 apk 文件 进行 签名 ， 会 
失去 优化 效果 。 


= 
DE 


发 布 到 Google Play Store 


完成 对 APK 文件 的 签名 后 ， 就 可 以 将 应 用 程序 发 布 到 Google 公司 提供 的 网 络 发 布 平台 
Google Play Store 中 了 . 


图 12.17 发 布 到 Google Play Store 
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Google Play Store 原名 Android Market (Android 市 场 ) . Android Market 是 Google JJ Android 
设备 开发 的 在 线 应 用 程序 商店 。Android 手机 在 出 三 时 已 经 预 装 了 Android Market, Android 用 户 
可 以 通过 Android Market 浏览 和 下 载 第 三 方 开发 者 发 布 的 Android 应 用 程序 ， 同 时 也 可 以 将 自己 
开发 的 应 用 程序 发 布 到 Android Market 上 供 其 他 用 户 下载 和 使 用 。Google 通 过 Android Market 将 
全 球 的 Android 用 户 联系 在 了 一 起 ， 同 时 也 为 Android 用 户 提供 了 创业 的 平台 。 

随 着 Android 系统 本 身 地 位 不 断 攀 升 ， 占 领 了 全 球 大 部 分 智能 手机 市 场 的 同时 ，Android 
Market 却 在 被 快速 的 边缘 化 ， 于 是 Google 在 Android Market 中 加 入 了 电影 ， 电 子 书 和 音乐 
〈 仅 限于 美国 地 区 ) 等 服务 ， 丰 富 其 功能 ， 想 让 其 成 为 一 个 超级 市 场 。 

北京 时 间 2012 年 3 月 7 日 凌晨 ，Google 公司 将 Android Market 正式 更 名 为 Google Play 
Store。 此 举 旨 在 让 消费 者 更 加 清楚 地 认识 到 Google 提供 的 一 系列 广泛 内 容 ， 而 不 只 是 用 于 
Android 智能 手机 和 平板 电脑 的 应 用 ， 以 便 提 升 自身 在 电子 内 容 销售 市 场 上 的 形象 以 及 更 好 
地 与 苹果 和 亚马逊 竞争 。 

对 于 Android 开发 者 来 说 ， 在 Google Play Store 中 注册 后 ， 只 要 一 次 性 支付 25 美元 ， 便 
可 成 为 Google Play Store 的 会 员 ， 进 而 可 以 在 该 平台 上 发 布 自己 的 软件 ， 并 可 以 通过 Google 
Play Store 提供 的 信息 统计 平台 查看 到 该 软件 被 下 载 、 安 装 、 评 级 等 相关 信息 。 


12.9 小 结 


本 章 简单 介绍 了 Android 应 用 程序 发 布 过 程 中 涉及 的 方法 和 步骤 ， 讲 解 了 对 Android 应 
用 程序 进行 签名 的 重要 性 。 对 Android 应 用 程序 进行 签名 之 前 需要 先生 成 签名 文件 。Android 
的 签名 文件 不 需要 向 权威 机 构 申 请 ， 可 以 由 开发 者 自己 生成 。 生 成 数字 签名 有 两 种 方式 ， 第 

-种 方式 为 使 用 Eclipse 的 ADT 插 件 ， 第 二 种 方式 是 使 用 keytool 命令 。 为 应 用 程序 签名 也 有 

两 种 方式 ， 分 别 为 ADT 插件 和 jarsigner 命令 。 

Android 应 用 程序 经 过 签名 后 ， 就 可 以 发 布 了 。 目 前 来 讲 ， 最 大 的 Android 应 用 程序 发 布 
平台 为 Google Play Store， 可 以 被 全 世界 的 用 户 直接 访问 。 

希望 读者 能 通过 Google Play Store， 赚 到 自己 的 第 一 桶 金 ! 


12.10 思考 是 


1. Android 应 用 程序 发 布 的 步骤 是 什么 ? 

2. Android 系统 为 什么 要 求 应 用 程序 在 安装 前 必须 被 签名 ? 
3. 怎样 才能 生成 自己 的 签名 文件 ? 

4. 怎样 为 应 用 程序 签名 ? 


Android 4.1 XT, 4.2 
THK T 


从 本 章节 可 以 学 习 到 : 

** Android 4.1 简介 

** Android 4.1 下 载 与 安装 
学 Android 4.2 也 来 了 
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] 3 ] Android 4.1 简介 


2012 4 6 H 28 H, Google 发 布 了 最 新 版 本 的 Android 操作 系统 Jelly Bean (果冻 豆 ) 。 
Android 4.1 是 有 史 以 来 运行 最 快 、 最 平滑 的 Android 操作 系统 ， 与 Android 4.0 相 比 ，Jelly 
Bean 进行 了 一 系列 的 改良 。 本 章 对 Android 4.1 的 部 分 特性 做 简单 介绍 。 
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更 好 的 使 用 体验 。Jelly Bean 将 系统 的 帧 率 设 定 为 60 帧 / 秒 ， 大 大 提升 了 系统 的 响应 速 
度 。 为 图 形 管道 提供 三 重 缓存 ， 使 得 CPU. GPU 和 屏幕 可 以 各 自 独立 运行 ， 泻 染 速 
度 最 大 可 达 120 帧 / 秒 ， 使 动画 效果 更 加 流畅 。Jelly Bean 被 设计 为 当 用 户 开始 触摸 屏 
幕 时 CPU 就 开始 全 速 工作 ， 这 样 虽然 会 使 耗 电量 增加 ， 但 是 却 可 以 最 大 幅度 避免 延 
退 现象 出 现 ， 明 显 提升 用 户 的 实际 体验 。 

AKT Google Now 搜索 功能 。Google Now X Jelly Bean 版 本 最 大 的 亮点 ， 会 根据 用 
户 所 处 的 位 置 、 时 间 进 行 相应 搜索 。 在 Android 4.1 设备 上 用 户 会 获得 更 好 的 搜索 体 
验 。Google Now 拥有 了 新 的 外 观 和 更 加 自然 的 声音 ， 并 且 搜 索 更 快 。Google Now 使 
用 知识 卡片 (Knowledge Graph) 显示 搜索 结果 ， 并 且 支 持 语音 搜索 。Google Now 可 
以 在 合适 的 时 间 自 动 获取 合适 的 信息 而 不 需要 用 户 手动 进行 搜索 。 比 如 当 您 早上 醒 
3k. Google Now 会 为 您 获取 当天 的 天 气 信息 ; 当 您 准备 出 发 去 工作 时 ，Google Now 
会 自动 为 您 搜索 交通 信息 ; 当 您 等 车 时 ，Google Now 会 自动 为 您 搜索 下 班车 的 时 间 
dk. 或 者 为 您 搜索 您 喜欢 的 球 队 的 比赛 信息 等 等 。 

通知 栏 。Jelly Bean 对 通知 栏 了 进行 一 些 功能 性 调整 ， 使 得 更 加 易于 使 用 。Jelly Bean 
的 通知 栏 在 视觉 上 更 加 美观 ， 同 时 还 加 入 了 日 期 和 时 间 的 显示 。 通 知 栏 中 的 通知 可 以 
直接 被 拉 伸 至 两 倍 大 小 ， 这 样 用 户 不 必 打 开 应 用 便 可 获得 更 多 信息 。 另 外 ， 一 些 通知 
可 以 让 用 户 直接 进行 操作 。 比 如 用 户 可 以 单 击 图 片上 的 分 享 按钮 ， 将 图 片 发 布 到 网 络 
上 ; 用 户 直接 点 击 未 接 来 电 会 出 现 选择 菜单 ， 用 户 可 以 选择 回 拨 电 话 。 

更 智能 的 键盘 。Jelly Bean 提供 更 加 准确 的 、 相 关 性 更 强 的 字典 功能 。Jelly Bean 的 语 
言 模型 是 一 直 在 调整 的 ， 在 用 户 开 始 输入 之 前 ，Jelly Bean 的 键盘 功能 会 根据 用 户 的 
特点 猜想 用 户 即将 输入 的 单词 是 什么 。 此 外 ，Jelly Bean 的 语音 -文字 转换 功能 更 强 ， 
并 且 无 需 网 络 连接 就 可 以 工作 。 这 样 用 户 就 可 以 在 任何 情况 下 通过 语音 进行 输入 。 
姿态 模式 。Jelly Bean 支持 姿态 模式 。 在 这 种 模式 下 ， 讶 人 可 以 在 语音 的 配合 下 ， 通 
过 上 点击、 摇晃 等 姿势 完成 对 U 的 控制 。 另 外 Jelly Bean 通过 USB 和 蓝牙 支持 外 部 的 
盲人 输入 输出 设备 。 

更 好 的 多 媒体 功能 。Jelly Bean 可 以 以 很 快 的 速度 进行 拍照 ， 并 且 将 照片 以 幻灯 片 方 
式 放 映 出 来 ， 用 户 可 以 通过 单 击 的 方式 决定 将 该 图 片 删除 或 者 共享 到 网 络 。 

Android Beam。 通 过 Android Beam 功能 ， 用 户 可 以 通过 一 个 轻 轻 地 碰撞 就 轻易 地 共 


9813€ Android 4.1KT, 4. 2 也 来 了 


享 各 种 信息 。 将 两 个 开启 了 NEFC 技术 的 Android 设 备 背 靠背 放 在 一 起 ， 然 后 轻 轻 碰撞 
一 下 ， 屏 幕 上 显示 的 内 容 就 会 被 发 送 给 对 方 。 

e 硬件 平台 开发 包 (PDK). 之 前 Google 向 软件 开发 商 提供 软件 开发 包 (SDK), B 
Jelly Bean 版 本 起 ，Google 开始 向 芯片 组 厂商 和 其 他 硬件 开发 商 发 放 硬 件 开发 套件 ， 
以 便 将 Android 接 入 到 他 们 的 硬件 中 。 


当然 ，Android 4.1 的 特性 不 仅仅 前 面 提 到 的 这 几 项 。 与 Android 4.0 相 比 ，Android 4.1 做 
了 大 量 的 改进 ， 由 于 篇 幅 原因 在 此 不 一 一 叙述 。 感 兴趣 的 读者 可 以 到 http://www.android.com/ 
about/jelly-bean/ 查 看 具体 内 容 。 

在 Android 4.1 发 布 之 时 ，Google 将 其 定义 为 世界 上 最 受 欢迎 的 智能 设备 平台 ， 可 见 其 对 
Android 4.1 的 信心 和 重视 。 目 前 Android 4.1 仅 被 应 用 在 Nexus 平台 上 ， 随 着 时 间 的 推移 ， 越 
来 越 多 的 移动 设备 会 应 用 该 系统 。Android 4.1 最 终 能 引起 怎样 的 市 场 震动 ， 我 们 拭目以待 ! 


] 3 M. Android 4.1 下 载 与 安装 


Android 4.1 SDK 的 安装 过 程 与 Android 4.0 完全 相同 ， 在 此 仅 作 简单 介绍 ， 有 具体 操作 过 
程 请 参考 第 2 章 2.2 节 。 
EIn 下 载 并 安装 JDK。 
ŒI 下 载 并 安装 SDK。 


到 http://developer.android.com/sdk/index.html， 下 载 SDK 开发 包 ， 然 后 双击 安装 ， 下 载 
页 面 如 图 13.1 所 示 。 


Getthe Android SDK 


The Android SDK provides you the API libraries and 
developer tools necessary to build, test, and debug 
apps for Android 


Download the SDK for Windows 


Other platforms | System requirements 


13.1 下 载 Android 4.1 SDK 


€XJ3os 下 载 并 安装 Eclipse。 
人 4 下 载 并 安装 ADT。 到 http://developer.android.com/sdk/installing/installing-adt.html 页 
面 下 载 ADT， 如 图 13.2 所 示 。 下 载 后 ， 执 行 Eclipse | Help | Install New Software 命 
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令 安装 ADT。 
CE 
ADT 20.0.0 ADT-20.0.0.zip 12387628 bytes ea0fc934af3b6b89097f0146c7822ed0 


13.2 FË ADT 


€o = 24 Android SDK Manager， 下 载 相关 文档 ， 如 图 13.3 所 示 。 


£3 Android SDK Manager cg X 
Packages Tools = 
SDK Path: G:\android-sdks 
Packages 
È Name APL Rev. Status 2 
P G Tools 

E X Android SDK Tools 20 Š installed E 

加 党 Android SDK Platform-tools 12 $ installed 

| Œ Android 4.1 (API 16) 

回国 Documentation for Android SDK 16 1 B installed 

E 4 SOK Platform 16 1 Š installed 

[E d$ Samples for SOK 16 1 Dinstalled 

[7] ® ARM EABI v7a System Image 16 1 Æ installed 

El % Google APIs 16 1 installed 

E E) Sources for Android SDK 16 1 $ installed 

| (&] Android 4.0.3 (API 15) 

| (&i Android 4.0 (API 14) z 
Show: (V|Updates/New [7] Installed Obsolete Select New or Updates install packages 
Sort by: @ API level Repository lect All elete packages... |i 
- "Ê. Ò 
Done loading packages. 


图 13.3 Android SDK Manager 


DI06 创建 AVD， 启 动 后 的 AVD 如 图 13.4 所 示 。 


图 13.4 AVD 
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9813€ Android 4.1KT, 4. 2 也 来 了 


通过 以 上 步 又， 搭建 好 开发 环境 后 ， 就 可 以 新 建 Android 工程 ， 开 发 Android 4.1 新 特性 
的 应 用 程序 了 。 


] 3 - 3 Android 4.2 也 来 了 


2012 4 10 月 底 ，Google 在 网 上 以 在 线 的 形式 发 布 了 全 新 的 Android 4.2 系统 ， 以 及 新 一 
代 的 Nexus 系列 手机 LG Nexus 4 和 平板 电脑 Nexus 10。 这 两 款 移 动 设备 均 搭 载 Android 42 K 
统 ， 而 之 前 发 布 的 平板 电脑 Nexus 7， 一 段 时 间 后 系统 也 会 提示 升级 到 Android 4.2。Android 
4.2 新 系统 界面 改动 不 大 ， 代 号 还 称 为 Jelly Bean 不 变 ， 新 增 系统 了 全 景 拍照 以 及 无 线 同步 输 
出 等 实用 的 小 功能 ， 并 在 系统 层面 做 了 更 多 的 优化 。 系 统 新 增 功能 说 明 如 下 。 


e 360 度 全 景 拍摄 模式 。Android 42 中 加 入 了 全 景 拍摄 功能 。 这 个 全 景 拍摄 除了 支持 水 
平 横向 移动 拍照 以 外 ， 也 可 以 上 下 移动 ， 拍 摄 全 景 照片 ， 因 此 可 称 得 上 真正 意义 上 的 
360 度 全 景 拍摄 。 

e 手势 打字 键盘 。Android 4.2 上 新 出 现 的 这 个 功能 目的 在 于 提高 在 手机 以 及 平板 上 的 输 
入 效率 ， 用 户 只 需 快 速 输入 相关 的 单词 ， 系 统 会 自动 根据 输入 的 轨迹 或 者 手势 ， 准 确 
判断 出 用 户 输入 的 单词 。 

© 同一 平板 电脑 上 多 用 户 共享 使 有 用。 装载 Android 42 平板 电脑 上 ， 不 同 用 户 可 以 使 用 
不 同 的 空间 ( 桌面 不 一 样 ) ， 每 个 用 户 可 以 设置 自己 的 Homescreen, 5X. 
Widgets、 应 用 和 游戏 。 这 个 功能 建立 在 内 核 多 任务 的 特性 上 ， 能 无 须 登 录 登 出 就 在 
不 同 用 户 之 间 进 行 平滑 切换 。 需 要 注意 ， 这 个 功能 只 在 平板 电脑 上 实现 。 

© 无 线 同 步 输出 功能 。Android 42 将 支持 Miracast 影像 传输 协议 ， 这 是 一 种 Wi-Fi AK 
显示 的 共享 协议 。 它 可 以 让 Nexus 4 等 装载 Android 4.2 系 统 的 设备 ， 同 步 把 音频 和 视 
频 ， 通 过 无 线 的 传输 方式 显示 到 家 用 大 屏 电视 机 上 ， 类 似 于 革 果 的 AirPlay 功能 。 这 
样 移动 设备 上 播放 的 音频 、 视 频 、 照 片 等 内 容 可 以 在 家 用 电视 上 播放 出 来 。 

e 系统 运行 更 加 快速 和 平滑 。 在 Android 系统 微观 层面 上 ， 每 个 细节 更 加 快速 、 流 畅 和 
平滑 ， 比 如 ， 在 Homescreen 之 间 平 滑 过 渡 、 移 动 ， 以 及 在 不 同 应 用 之 间 毫 不 费力 地 
切换 。 

e 其 他 界面 上 的 优化 。 比 如 Daydream 屏幕 保护 、Gmail 邮件 内 容 放大 缩小 显示 、 可 扩 
展 通知 、Google Search 新 界面 、Widget 配 置 更 加 方便 等 等 。 


关于 Android 4.2 特性 和 系统 界面 ， 可 以 参看 Android 官方 网 站 。 读 者 可 在 等 这 个 版 本 的 
SDK 放出 来 后 ， 从 官网 上 下 载 下 来 安装 到 自己 的 机 器 上 感受 一 下 。 
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13.4 ra 


2012 年 6 月 28 H, Android 4.1 发 布 ， 带 来 了 大 量 的 新 特性 和 更 好 的 用 户 体验 。 本 章节 
简单 介绍 了 Android 4.1 的 几 个 新 特性 和 安装 方法 以 及 Android 42 的 新 特性 ， 感 兴趣 的 读者 
可 以 尝试 在 Android 4.1 平台 上 学 习 Android 开发 技术 ， 或 者 下 载 安装 Android SDK 4.2 进行 
学 习 。 
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